Documentação

Uma única API para modelos de chat, imagem e vídeo. O chat segue o formato Chat Completions da OpenAI, então qualquer SDK da OpenAI funciona trocando a URL base e a chave; as imagens seguem o formato de imagens da OpenAI; os vídeos rodam como tarefas.

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="")

Autenticação

Envie sua chave no cabeçalho Authorization. Crie chaves na página Chaves de API.

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

Uma chave pode ser limitada aos seus próprios endereços IP: na página Chaves de API, defina os endereços ou intervalos permitidos (por exemplo 203.0.113.7 ou 198.51.100.0/24). Requisições de qualquer outro lugar são recusadas com 403 ip_not_allowed.

Endpoints

Todos os caminhos são relativos à URL base. Toda requisição precisa da sua chave de API, exceto GET /models, que é pública; chamada com uma chave, lista apenas os modelos que essa chave pode usar.

Modelos

Lista os modelos que você pode usar. Cada um tem um tipo (chat, image ou video) e seus preços: por token no chat, por imagem em imagens, por 1M de tokens de vídeo conforme a resolução em vídeo.

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

Chat

POST /chat/completions aceita a requisição da OpenAI sem mudanças: messages, max_tokens, temperature, top_p, stop, tools e tool_choice, response_format, stream. Campos desconhecidos são repassados ao modelo. Toda resposta traz um cabeçalho x-request-id; informe-o ao falar com o suporte.

Streaming

Use "stream": true para receber server-sent events. Adicione "stream_options": {"include_usage": true} para obter as contagens de tokens no último trecho.

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

Cache de prompts

Prefixos de prompt repetidos (prompt de sistema, documentos longos, histórico do chat) são colocados em cache pelo provedor. Os tokens de entrada em cache são cobrados automaticamente pelo preço mais baixo de cache hit. Deixe a parte estável do prompt no início e sem alterações.

Faturamento

Cada requisição reserva seu custo máximo possível (tamanho do prompt mais max_tokens) e depois é cobrada pelos tokens realmente usados. Defina max_tokens para evitar erros 402 quando seu saldo estiver baixo. Requisições que falham antes do primeiro token não são cobradas. Imagens são cobradas por imagem gerada; vídeos por token de vídeo (veja Vídeo). Cada cobrança aparece em Registros de faturamento, na página Faturamento.

Limites de uso

Os limites valem por chave (requisições por minuto) e por conta (requisições simultâneas). Alguns modelos também têm seu próprio limite por conta.

GET /balance retorna o que a chave ainda pode gastar: balance_usd, credit_limit_usd e key_daily_cap_usd (null quando a chave não tem limite diário).

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
}

Erros

Os erros usam o formato da OpenAI: {"error": {"message", "type", "code"}}.

Imagens

Os modelos de imagem respondem a POST /images/generations, a mesma requisição da OpenAI. size é em pixels ("1024x1024") ou uma resolução que o modelo ofereça ("1K", "1.5K", "2K", "3K", "4K"; nem todo modelo tem todas) com um aspect_ratio opcional ("16:9"). Omita size para o tamanho padrão do modelo. output_format é "jpeg" (padrão) ou "png" nos modelos que oferecem. n vai de 1 a 4. Envie image (uma URL ou data URL, ou uma lista) para editar ou mudar o estilo de uma imagem. response_format "b64_json" retorna a imagem na própria resposta; "url" retorna um link que funciona por uma hora. Você paga por imagem gerada. Alguns modelos têm um segundo preço, mais alto, para imagens grandes (acima da quantidade de pixels indicada no modelo) e um preço por imagem de entrada, às vezes depois de algumas gratuitas; usage.input_images informa quantas foram cobradas. Os tamanhos, formatos, o limite de imagens de entrada e os preços de cada modelo estão na Referência de modelos abaixo e em GET /models (pricing.image, pricing.image_large, pricing.image_input e o 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

Os modelos de vídeo rodam como tarefas. POST /videos inicia uma e retorna o id na hora; consulte GET /videos/{id} a cada poucos segundos até status ser completed ou failed (normalmente de 1 a 5 minutos) e então baixe: a tarefa concluída traz uma url (um link para o arquivo, válido por uma semana e renovado a cada leitura; se não conseguimos armazenar o arquivo, url é o caminho /v1/videos/{id}/content) e GET /videos/{id}/content sempre busca o arquivo. O id de qualquer resposta (chatcmpl-…, img_…, video_…) e o request_id de qualquer erro são o que você deve informar ao suporte.

As referências são numeradas por tipo na ordem em que você as envia: o primeiro item de reference_images é a imagem 1, o segundo a imagem 2, e o mesmo vale para vídeos e áudios. Chame-as assim no prompt, como o playground faz com [Image 1], [Video 1] e [Audio 1], por exemplo "The woman in [Image 1] walks through the street of [Video 1]". Enviar mais arquivos do que o modelo aceita é recusado, não cortado.

status é queued, in_progress, completed ou failed. Uma tarefa concluída tem usage.video_tokens e usage.cost_usd; uma que falhou não é cobrada e traz error.code e error.message: generation_failed (o modelo não conseguiu gerar o vídeo), invalid_reference (um dos arquivos de referência foi recusado; a mensagem diz qual) ou 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 }
}

Rascunhos (Seedance 2.5): gere primeiro uma prévia barata em 480p e depois transforme a que você gostar no vídeo final em 1080p com a mesma seed e as mesmas configurações.

# 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_..."}'

O custo estimado é retido do seu saldo quando a tarefa começa: (segundos do vídeo de entrada + segundos de saída) em tokens de vídeo pelo preço daquela resolução. Ao terminar, você paga pelos tokens realmente gerados (cerca de 108K para 5 segundos em 720p) e o restante é liberado; uma tarefa que falha não custa nada. Em Configurações você pode trocar a cobrança de vídeo da tabela de preços por token para "por USD": a cobrança do próprio fornecedor pelo trabalho a preço de tabela, menos seu desconto. Cada registro de faturamento informa qual foi aplicada.

Guias de modelos

No que cada família de modelos de vídeo é boa, seus limites e como escrever prompts que o 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

Use os modelos a partir de um agente de IA com nosso servidor MCP hospedado (Streamable HTTP). Adicione a URL abaixo ao Claude Code, Cursor, Windsurf, VS Code ou qualquer cliente MCP, com sua chave de API no cabeçalho Authorization. As chamadas são cobradas do seu saldo pelos mesmos preços da 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-..." }
    }
  }
}

Ferramentas: list_models (os modelos e seus preços), chat (envia um prompt ou mensagens a um modelo e recebe a resposta), create_image (gera imagens e retorna os links), create_video (inicia um vídeo e retorna o id) e get_video (o status e, quando termina, o link para o arquivo).

CLI

O comando apistore roda modelos de chat, imagem e vídeo em um terminal ou script: entra texto, sai a resposta, e os arquivos são salvos onde você indicar. Requer Node 20 ou mais recente.

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

Todo comando aceita --json para a resposta bruta da API, e a chave também pode vir de APISTORE_API_KEY para scripts e CI. Rode apistore --help para ver todas as opções.

Referência de modelos

Modelos do mesmo tipo aceitam o mesmo formato de requisição. Os preços estão em créditos (1 US$ = 100 créditos): por 1M de tokens em chat e vídeo, por imagem em imagens. A própria API informa os valores em 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"
  }'