MercadoSoporte← Volver a la app

Seedream

Los modelos de Seedream se llaman a través de una API de trabajos asíncrona y unificada. Inicia una tarea con POST /api/generate y luego sondea GET /api/generate/{taskId} hasta que termine. Esta familia expone 10 endpoints.

Resumen

Todos los endpoints comparten la misma envoltura — solo cambian model y los campos input. Ejecuta cualquiera desde el playground del Mercado de modelos.

Autenticación

Crea una API key en /api-keys y luego envíala como token Bearer. Las solicitudes desde el navegador con sesión iniciada también funcionan mediante la cookie de sesión.

Authorization: Bearer <YOUR_API_KEY>

Crear tarea

POST
POST https://97ai.97claude.com/api/generate

Cuerpo: { "model": "<slug>", "input": { … } }

Respuesta: { "taskId": "<id>", "state": "waiting" }

Consultar resultado

GET
GET https://97ai.97claude.com/api/generate/<taskId>

Respuesta: { "taskId", "state": "waiting" | "success" | "fail", "resultUrls": [ … ], "creditsConsumed", "failMsg", "balance" }

Asíncrono
Un 200 de Crear tarea solo significa que la tarea fue aceptada — no que haya terminado. Sondea este endpoint hasta que state sea success o fail. Las tareas fallidas no se facturan.

Endpoints

ModeloTareamodel slug
SeedreamText to Imageseedream/seedream
Seedream V4Text to Imageseedream/seedream-v4-text-to-image
Seedream V4 EditImage Editingseedream/seedream-v4-edit
Seedream 4.5Text to Imageseedream/4-5-text-to-image
Seedream 4.5 EditImage Editingseedream/4-5-edit
Seedream 5 LiteText to Imageseedream/5-lite-text-to-image
Seedream 5 LiteImage to Imageseedream/5-lite-image-to-image
Seedream 5 ProText to Imageseedream/5-pro-text-to-image
Seedream 5 ProImage to Imageseedream/5-pro-image-to-image
Seedream V3Text to Imageseedream/seedream-v3

Seedream · Text to Image

POSTText to Imageseedream/seedream
campos input
promptstringobligatorio

Text prompt describing the desired output.

aspect_ratiostringopcional

Output aspect ratio, e.g. "1:1", "16:9".

Ejemplo
cURL
curl -X POST https://97ai.97claude.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream/seedream",
    "input": { "prompt": "a red panda", "aspect_ratio": "1:1" }
  }'

Seedream V4 · Text to Image

POSTText to Imageseedream/seedream-v4-text-to-image
campos input
promptstringobligatorio

Text prompt describing the desired output.

aspect_ratiostringopcional

Output aspect ratio, e.g. "1:1", "16:9".

Ejemplo
cURL
curl -X POST https://97ai.97claude.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream/seedream-v4-text-to-image",
    "input": { "prompt": "a red panda", "aspect_ratio": "1:1" }
  }'

Seedream V4 Edit · Image Editing

POSTImage Editingseedream/seedream-v4-edit
campos input
promptstringobligatorio

Text prompt describing the desired output.

image_urlsstring[]obligatorio

One or more source image URLs to condition on.

Ejemplo
cURL
curl -X POST https://97ai.97claude.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream/seedream-v4-edit",
    "input": { "prompt": "a red panda", "image_urls": ["https://example.com/in.jpg"] }
  }'

Seedream 4.5 · Text to Image

POSTText to Imageseedream/4-5-text-to-image
campos input
promptstringobligatorio

Text prompt describing the desired output.

aspect_ratiostringopcional

Output aspect ratio, e.g. "1:1", "16:9".

Ejemplo
cURL
curl -X POST https://97ai.97claude.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream/4-5-text-to-image",
    "input": { "prompt": "a red panda", "aspect_ratio": "1:1" }
  }'

Seedream 4.5 Edit · Image Editing

POSTImage Editingseedream/4-5-edit
campos input
promptstringobligatorio

Text prompt describing the desired output.

image_urlsstring[]obligatorio

One or more source image URLs to condition on.

Ejemplo
cURL
curl -X POST https://97ai.97claude.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream/4-5-edit",
    "input": { "prompt": "a red panda", "image_urls": ["https://example.com/in.jpg"] }
  }'

Seedream 5 Lite · Text to Image

POSTText to Imageseedream/5-lite-text-to-image
campos input
promptstringobligatorio

Text prompt describing the desired output.

aspect_ratiostringopcional

Output aspect ratio, e.g. "1:1", "16:9".

Ejemplo
cURL
curl -X POST https://97ai.97claude.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream/5-lite-text-to-image",
    "input": { "prompt": "a red panda", "aspect_ratio": "1:1" }
  }'

Seedream 5 Lite · Image to Image

POSTImage to Imageseedream/5-lite-image-to-image
campos input
promptstringobligatorio

Text prompt describing the desired output.

image_urlsstring[]obligatorio

One or more source image URLs to condition on.

Ejemplo
cURL
curl -X POST https://97ai.97claude.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream/5-lite-image-to-image",
    "input": { "prompt": "a red panda", "image_urls": ["https://example.com/in.jpg"] }
  }'

Seedream 5 Pro · Text to Image

POSTText to Imageseedream/5-pro-text-to-image
campos input
promptstringobligatorio

Text prompt describing the desired output.

aspect_ratiostringopcional

Output aspect ratio, e.g. "1:1", "16:9".

Ejemplo
cURL
curl -X POST https://97ai.97claude.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream/5-pro-text-to-image",
    "input": { "prompt": "a red panda", "aspect_ratio": "1:1" }
  }'

Seedream 5 Pro · Image to Image

POSTImage to Imageseedream/5-pro-image-to-image
campos input
promptstringobligatorio

Text prompt describing the desired output.

image_urlsstring[]obligatorio

One or more source image URLs to condition on.

Ejemplo
cURL
curl -X POST https://97ai.97claude.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream/5-pro-image-to-image",
    "input": { "prompt": "a red panda", "image_urls": ["https://example.com/in.jpg"] }
  }'

Seedream V3 · Text to Image

POSTText to Imageseedream/seedream-v3
campos input
promptstringobligatorio

Text prompt describing the desired output.

aspect_ratiostringopcional

Output aspect ratio, e.g. "1:1", "16:9".

Ejemplo
cURL
curl -X POST https://97ai.97claude.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream/seedream-v3",
    "input": { "prompt": "a red panda", "aspect_ratio": "1:1" }
  }'