PixSEO API

curl -X POST https://api.pixseo.ai/api/keys/register \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "password": "your_password"}'

# 返回:
# { "api_key": "pixseo_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", ... }

curl -X POST https://api.pixseo.ai/api/keys/me/create-sandbox \
  -H "X-API-Key: pixseo_xxxxxxxxxxxx"

# 返回:
# { "api_key": "pixseo_xxxxxxxxxxxx", "usage_limit": 10, ... }

curl -X POST https://api.pixseo.ai/api/v1/process \
  -H "X-API-Key: pixseo_xxxxxxxxxxxx" \
  -F "image=@product.jpg" \
  -F "title=Wireless Bluetooth Earbuds" \
  -F "product_type=Electronics"

import requests

url = "https://api.pixseo.ai/api/v1/process"
headers = {"X-API-Key": "pixseo_xxxxxxxxxxxx"}

with open("product.jpg", "rb") as f:
    files = {"image": f}
    data = {
        "title": "Wireless Bluetooth Earbuds",
        "product_type": "Electronics",
    }
    resp = requests.post(url, headers=headers, files=files, data=data)

result = resp.json()
# result["processed_image_base64"] - 处理后的图片 (base64)
# result["alt_texts"] - 多语言 Alt 文本
# result["seo_filename"] - SEO 文件名

const formData = new FormData();
formData.append("image", fileInput.files[0]);
formData.append("title", "Wireless Bluetooth Earbuds");
formData.append("product_type", "Electronics");

const resp = await fetch("https://api.pixseo.ai/api/v1/process", {
    method: "POST",
    headers: { "X-API-Key": "pixseo_xxxxxxxxxxxx" },
    body: formData,
});

const result = await resp.json();
// result.processed_image_base64 - 处理后的图片
// result.alt_texts - 多语言 Alt 文本

{
  "request_id": "a3f2b1c9d4e5",       // 请求追踪 ID
  "original_size": 245760,
  "original_size_kb": 240.0,
  "original_name": "product.jpg",
  "processed_size": 48200,
  "processed_size_kb": 47.1,
  "processed_image_base64": "...",     // 仅当 return_image=true 时返回
  "reduction_percent": 80.4,
  "alt_texts": {
    "zh": "无线蓝牙耳机 - 高品质电子产品",
    "en": "Wireless Bluetooth Earbuds - premium electronics",
    "ja": "ワイヤレスBluetoothイヤホン - 高品質電子製品",
    "de": "Kabellose Bluetooth-Ohrhörer - Premium-Elektronik",
    "fr": "Écouteurs Bluetooth sans fil - électronique premium"
  },
  "seo_filename": "wireless-bluetooth-earbuds-1.webp",
  "seo_schema": "{...}",              // JSON-LD Product Schema (Google Shopping)
  "steps": {                          // 各处理步骤状态
    "background_removal": "success",  // success | skipped | failed
    "compression": "success",
    "alt_text": "success"
  },
  "elapsed_ms": 1234                  // 处理耗时（毫秒）
}

curl -X POST https://api.pixseo.ai/api/v1/schema/generate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: pixseo_xxxxxxxxxxxx" \
  -d '{
    "title": "Wireless Bluetooth Earbuds",
    "product_type": "Electronics",
    "description": "Premium wireless earbuds with noise cancellation",
    "image_url": "https://cdn.example.com/earbuds.webp",
    "price": 79.99,
    "brand": "SoundMax",
    "sku": "SM-EB-001"
  }'

{
  "request_id": "a3f2b1c9d4e5",
  "schema_jsonld": "{\n  \"@context\": \"https://schema.org\",\n  \"@graph\": [...]\n}",
  "schema_plain": "{\"@context\":\"https://schema.org\",\"@graph\":[...]}",
  "google_structured_data_test_url": "https://search.google.com/test/rich-results"
}

curl -X POST https://api.pixseo.ai/api/v1/listing/generate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: pixseo_xxxxxxxxxxxx" \
  -d '{
    "title": "Wireless Bluetooth Earbuds",
    "product_type": "Electronics",
    "features": "Noise cancellation, 30hr battery, IPX5 waterproof, Bluetooth 5.3",
    "target_market": "US",
    "language": "en",
    "tone": "professional"
  }'

{
  "request_id": "b4g3c2d0e5f6",
  "title_optimized": "Wireless Bluetooth Earbuds with Noise Cancellation - 30hr Battery",
  "description": "Experience premium sound with...",
  "bullet_points": [
    "Advanced noise cancellation technology",
    "30-hour battery life",
    "IPX5 waterproof rating",
    "Bluetooth 5.3 connectivity",
    "Ergonomic design for all-day comfort"
  ],
  "seo_meta": {
    "meta_title": "Wireless Bluetooth Earbuds | Noise Cancelling | PixSEO",
    "meta_description": "Premium wireless earbuds with...",
    "url_slug": "wireless-bluetooth-earbuds-noise-cancellation"
  },
  "target_keywords": ["wireless earbuds", "bluetooth earphones", ...],
  "elapsed_ms": 1234
}

curl https://api.pixseo.ai/api/v1/usage \
  -H "X-API-Key: pixseo_xxxxxxxxxxxx"

# 返回:
# { "plan": "free", "used": 25, "limit": 50, "remaining": 25, "is_sandbox": false }