Documentación

Una sola API para modelos de chat, imagen y video. El chat sigue el formato Chat Completions de OpenAI, así que cualquier SDK de OpenAI funciona cambiando la URL base y la clave; las imágenes siguen el formato de imágenes de OpenAI; los videos se ejecutan como tareas.

Quickstart

from openai import OpenAI

client = OpenAI(base_url="https://api.apistore.cloud/v1", api_key="sk-...")

stream = client.chat.completions.create(
    model="deepseek-v4-1-flash",
    messages=[{"role": "user", "content": "Hello!"}],
    stream=True,
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")

Autenticación

Envía tu clave en el encabezado Authorization. Crea claves en la página Claves de API.

Authorization: Bearer sk-...
Base URL: https://api.apistore.cloud/v1

Una clave puede limitarse a tus propias direcciones IP: en la página Claves de API, define sus direcciones o rangos permitidos (por ejemplo 203.0.113.7 o 198.51.100.0/24). Las solicitudes desde cualquier otro lugar se rechazan con 403 ip_not_allowed.

Endpoints

Todas las rutas son relativas a la URL base. Toda solicitud necesita tu clave de API, salvo GET /models, que es pública; con una clave, lista solo los modelos que esa clave puede usar.

Modelos

Lista los modelos que puedes usar. Cada uno tiene un tipo (chat, image o video) y sus precios: por token en chat, por imagen en imágenes, por 1M de tokens de video según la resolución en video.

curl https://api.apistore.cloud/v1/models

Chat

POST /chat/completions acepta la solicitud de OpenAI sin cambios: messages, max_tokens, temperature, top_p, stop, tools y tool_choice, response_format, stream. Los campos desconocidos se pasan al modelo. Cada respuesta trae un encabezado x-request-id; cítalo cuando contactes a soporte.

Streaming

Usa "stream": true para recibir server-sent events. Agrega "stream_options": {"include_usage": true} para obtener los conteos de tokens en el último fragmento.

{
  "model": "deepseek-v4-1-flash",
  "stream": true,
  "stream_options": { "include_usage": true },
  "messages": [{ "role": "user", "content": "Hello" }]
}

Caché de prompts

Los prefijos de prompt repetidos (prompt del sistema, documentos largos, historial del chat) son almacenados en caché por el proveedor. Los tokens de entrada en caché se cobran automáticamente al precio más bajo de acierto de caché. Deja la parte estable del prompt al inicio y sin cambios.

Facturación

Cada solicitud reserva su costo máximo posible (tamaño del prompt más max_tokens) y luego se cobra por los tokens realmente usados. Define max_tokens para evitar errores 402 cuando tu saldo sea bajo. Las solicitudes que fallan antes del primer token no se cobran. Las imágenes se cobran por imagen generada; los videos por token de video (ver Video). Cada cargo aparece en Registros de facturación, en la página Facturación.

Límites de uso

Los límites se aplican por clave (solicitudes por minuto) y por cuenta (solicitudes simultáneas). Algunos modelos tienen además su propio límite por cuenta.

GET /balance devuelve lo que la clave todavía puede gastar: balance_usd, credit_limit_usd y key_daily_cap_usd (null cuando la clave no tiene límite diario).

curl https://api.apistore.cloud/v1/balance -H "Authorization: Bearer sk-..."

{
  "object": "balance",
  "account": "Acme",
  "balance_usd": 42.5,
  "credit_limit_usd": 0,
  "key_daily_cap_usd": null
}

Errores

Los errores usan el formato de OpenAI: {"error": {"message", "type", "code"}}.

Imágenes

Los modelos de imagen responden a POST /images/generations, la misma solicitud que OpenAI. size son píxeles ("1024x1024") o una resolución que el modelo ofrezca ("1K", "1.5K", "2K", "3K", "4K"; no todos los modelos tienen todas) con un aspect_ratio opcional ("16:9"). Omite size para el tamaño estándar del modelo. output_format es "jpeg" (por defecto) o "png" en los modelos que lo ofrecen. n va de 1 a 4. Envía image (una URL o data URL, o una lista) para editar o cambiar el estilo de una imagen. response_format "b64_json" devuelve la imagen en la respuesta; "url" devuelve un enlace que funciona durante una hora. Pagas por imagen generada. Algunos modelos tienen un segundo precio, más alto, para imágenes grandes (por encima de la cantidad de píxeles indicada en el modelo) y un precio por imagen de entrada, a veces después de algunas gratis; usage.input_images indica cuántas se cobraron. Los tamaños, formatos, el límite de imágenes de entrada y los precios de cada modelo están en la Referencia de modelos más abajo y en GET /models (pricing.image, pricing.image_large, pricing.image_input y el objeto image).

// response
{
  "id": "img_0123456789abcdef0123456789abcdef",
  "created": 1793984023,
  "model": "MODEL_NAME",
  "data": [{ "url": "https://api.apistore.cloud/v1/files/images/..." }],
  "usage": { "images": 1, "input_images": 1, "cost_usd": 0.04 }  // input_images: only when some were billed
}

Video

Los modelos de video se ejecutan como tareas. POST /videos inicia una y devuelve su id de inmediato; consulta GET /videos/{id} cada pocos segundos hasta que status sea completed o failed (normalmente de 1 a 5 minutos) y luego descárgalo: la tarea terminada trae una url (un enlace al archivo, válido por una semana y renovado en cada lectura; si no pudimos almacenar el archivo, url es la ruta /v1/videos/{id}/content) y GET /videos/{id}/content siempre obtiene el archivo. El id de cualquier respuesta (chatcmpl-…, img_…, video_…) y el request_id de cualquier error son lo que debes citar a soporte.

Las referencias se numeran por tipo en el orden en que las envías: el primer elemento de reference_images es la imagen 1, el segundo la imagen 2, y lo mismo para videos y audios. Nómbralas así en el prompt, como hace el playground con [Image 1], [Video 1] y [Audio 1], por ejemplo "The woman in [Image 1] walks through the street of [Video 1]". Enviar más archivos de los que acepta el modelo se rechaza, no se recorta.

status es queued, in_progress, completed o failed. Una tarea completada tiene usage.video_tokens y usage.cost_usd; una fallida no se cobra y trae error.code y error.message: generation_failed (el modelo no pudo generar el video), invalid_reference (uno de los archivos de referencia fue rechazado; el mensaje indica cuál) o timeout.

// GET https://api.apistore.cloud/v1/videos/video_...
{
  "id": "video_0123456789abcdef0123456789abcdef",
  "object": "video",
  "model": "MODEL_NAME",
  "status": "completed",
  "created_at": 1793984023,
  "completed_at": 1793984214,
  "prompt": "A red paper boat drifting across a calm lake at sunrise",
  "resolution": "720p",
  "ratio": "16:9",
  "seconds": 5,
  "draft": false,
  "seed": 49873,
  "url": "https://.../video_0123456789abcdef0123456789abcdef.mp4",
  "last_frame": null,
  "error": null,
  "usage": { "video_tokens": 108000, "cost_usd": 1.0978 }
}

Borradores (Seedance 2.5): genera primero una vista previa barata en 480p y luego convierte la que te guste en el video final a 1080p con la misma semilla y los mismos ajustes.

# 1. the draft: 480p, at the 480p price
curl https://api.apistore.cloud/v1/videos -H "Authorization: Bearer sk-..." -H "Content-Type: application/json" \
  -d '{"model": "MODEL_NAME", "prompt": "A red paper boat on a lake", "seconds": 5, "resolution": "480p", "draft": true}'

# 2. when it is completed, the final video at 1080p
curl https://api.apistore.cloud/v1/videos -H "Authorization: Bearer sk-..." -H "Content-Type: application/json" \
  -d '{"model": "MODEL_NAME", "draft_id": "video_..."}'

El costo estimado se retiene de tu saldo cuando la tarea empieza: (segundos del video de entrada + segundos de salida) en tokens de video al precio de esa resolución. Al terminar pagas por los tokens realmente generados (unos 108K por 5 segundos a 720p) y el resto se libera; una tarea fallida no cuesta nada. En Ajustes puedes cambiar la facturación de video de la lista de precios por token a "por USD": el cargo del propio proveedor por el trabajo a precio de lista, menos tu descuento. Cada registro de facturación indica cuál se aplicó.

Guías de modelos

Para qué sirve cada familia de modelos de video, sus límites y cómo escribir prompts que el modelo siga.

[Image 1] is the fisherman, [Image 2] is his boat. Documentary style, natural light.
0-6 s: wide shot at water level, the boat drifts through morning mist. Slow push in.
6-14 s: medium shot, he pulls the net in, hand over hand. Water drips from the rope.
14-20 s: close-up on his face as he looks at the catch and smiles.
Ambient sound only: water, wood, gulls. No subtitles, no background music.

[Image 1] is the girl in the red coat, [Image 2] is the night market. Follow the camera of [Video 1].
Shot 1: wide shot, she walks in between the stalls. Slow push in.
Shot 2: medium shot, she stops at a lantern stall and lifts one lantern. Fixed camera.
Shot 3: close-up, warm light on her face. She says {This one}.
Cinematic, warm tones, rich detail. Keep it subtitle-free. Do not generate a logo or watermark.

MCP

Usa los modelos desde un agente de IA con nuestro servidor MCP alojado (Streamable HTTP). Agrega la URL de abajo a Claude Code, Cursor, Windsurf, VS Code o cualquier cliente MCP, con tu clave de API en el encabezado Authorization. Las llamadas se cobran de tu saldo a los mismos precios que la API.

URL: https://api.apistore.cloud/mcp
Authorization: Bearer sk-...

# Claude Code
claude mcp add --transport http apistore https://api.apistore.cloud/mcp \
  --header "Authorization: Bearer sk-..."

# Cursor (~/.cursor/mcp.json), Windsurf, VS Code and other MCP clients
{
  "mcpServers": {
    "apistore": {
      "url": "https://api.apistore.cloud/mcp",
      "headers": { "Authorization": "Bearer sk-..." }
    }
  }
}

Herramientas: list_models (los modelos y tus precios), chat (envía un prompt o mensajes a un modelo y recibe su respuesta), create_image (genera imágenes y devuelve sus enlaces), create_video (inicia un video y devuelve su id) y get_video (su estado y, cuando termina, el enlace al archivo).

CLI

El comando apistore ejecuta modelos de chat, imagen y video desde una terminal o un script: entra texto, sale la respuesta, y los archivos se guardan donde indiques. Requiere Node 20 o posterior.

npm install -g @apistorecloud/apistore
apistore login --key sk-...

apistore chat -m deepseek-v4-1-flash "Hello!"
apistore chat "Summarize this" < notes.md
apistore image "a red bicycle on a white wall" -o bike.png
apistore video "waves at sunset, slow pan" --resolution 720p --seconds 5

Todos los comandos aceptan --json para la respuesta cruda de la API, y la clave también puede venir de APISTORE_API_KEY para scripts y CI. Ejecuta apistore --help para ver todas las opciones.

Referencia de modelos

Los modelos del mismo tipo aceptan el mismo formato de solicitud. Los precios están en créditos (1 US$ = 100 créditos): por 1M de tokens en chat y video, por imagen en imágenes. La API informa los montos en USD (cost_usd, balance_usd).

# start the task
curl https://api.apistore.cloud/v1/videos \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Seedance-2.5",
    "prompt": "A red paper boat drifting across a calm lake at sunrise",
    "resolution": "720p",
    "ratio": "16:9",
    "seconds": 5
  }'

# poll until "status": "completed", then download
curl https://api.apistore.cloud/v1/videos/video_... -H "Authorization: Bearer sk-..."
curl https://api.apistore.cloud/v1/videos/video_.../content -H "Authorization: Bearer sk-..." -o video.mp4

curl https://api.apistore.cloud/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-1-flash",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

curl https://api.apistore.cloud/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-1-flash-economy",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

# start the task
curl https://api.apistore.cloud/v1/videos \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-0-fast",
    "prompt": "A red paper boat drifting across a calm lake at sunrise",
    "resolution": "720p",
    "ratio": "16:9",
    "seconds": 5
  }'

# poll until "status": "completed", then download
curl https://api.apistore.cloud/v1/videos/video_... -H "Authorization: Bearer sk-..."
curl https://api.apistore.cloud/v1/videos/video_.../content -H "Authorization: Bearer sk-..." -o video.mp4

# start the task
curl https://api.apistore.cloud/v1/videos \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "prompt": "A red paper boat drifting across a calm lake at sunrise",
    "resolution": "720p",
    "ratio": "16:9",
    "seconds": 5
  }'

# poll until "status": "completed", then download
curl https://api.apistore.cloud/v1/videos/video_... -H "Authorization: Bearer sk-..."
curl https://api.apistore.cloud/v1/videos/video_.../content -H "Authorization: Bearer sk-..." -o video.mp4

# start the task
curl https://api.apistore.cloud/v1/videos \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-mini",
    "prompt": "A red paper boat drifting across a calm lake at sunrise",
    "resolution": "720p",
    "ratio": "16:9",
    "seconds": 5
  }'

# poll until "status": "completed", then download
curl https://api.apistore.cloud/v1/videos/video_... -H "Authorization: Bearer sk-..."
curl https://api.apistore.cloud/v1/videos/video_.../content -H "Authorization: Bearer sk-..." -o video.mp4

curl https://api.apistore.cloud/v1/images/generations \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.0-flash",
    "prompt": "A red paper boat on a calm lake at sunrise",
    "size": "1.5K",
    "aspect_ratio": "16:9",
    "response_format": "url"
  }'

curl https://api.apistore.cloud/v1/images/generations \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.0-lite",
    "prompt": "A red paper boat on a calm lake at sunrise",
    "size": "2K",
    "aspect_ratio": "16:9",
    "response_format": "url"
  }'

curl https://api.apistore.cloud/v1/images/generations \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.0-pro",
    "prompt": "A red paper boat on a calm lake at sunrise",
    "size": "1.5K",
    "aspect_ratio": "16:9",
    "response_format": "url"
  }'

curl https://api.apistore.cloud/v1/images/generations \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.5",
    "prompt": "A red paper boat on a calm lake at sunrise",
    "size": "1.5K",
    "aspect_ratio": "16:9",
    "response_format": "url"
  }'