Referência da API

APIs antigas e compatibilidade

#Compatibilidade com a OpenAI

Todos os caminhos aceitam o corpo de requisição da OpenAI — parâmetros específicos do provedor (anthropic tool_use, gemini thinking_config) são repassados sem alteração.

Mesmo envelope de resposta da OpenAI

O corpo da resposta é idêntico ao da OpenAI, então parsers, lógica de novas tentativas e wrappers de observabilidade escritos para a OpenAI continuam funcionando.

Os endpoints desta página estão ativos e são cobrados como qualquer outro, mas não são a forma recomendada de integrar. Use-os quando um SDK de provedor existente precisar continuar funcionando sem alterações, ou quando você herdou uma chamada que ainda não está pronto para migrar.

#Qual interface você deve usar?

Nova integração

Use os endpoints /v1 no formato da OpenAI da referência da API. Um único vocabulário para todos os recursos, e a única interface que recebe novos parâmetros.

SDK de provedor existente

Use o repasse correspondente abaixo. Você troca a URL base e a chave e mantém o corpo de requisição do próprio provedor.

Chamada legada herdada

Continua funcionando. Migre na próxima vez que mexer nesse trecho de código — estas rotas estão congeladas, sem manutenção.

#Repasse nativo do provedor

Estas rotas aceitam o corpo de requisição do próprio provedor e retornam o formato de resposta dele. A autenticação continua sendo um único cabeçalho Authorization: Bearer com uma chave desta plataforma — o esquema de autenticação do provedor não é usado.

Gemini nativo

repasse

Aponte o Google GenAI SDK para este gateway sem mudar o código. O formato do caminho generateContent e o corpo da requisição são os do próprio Gemini.

GET	/v1beta/models	Lista os modelos no formato de catálogo do Gemini.
POST	/v1beta/models/*	Formato de caminho do Gemini: /v1beta/models/{model}:{action}, por exemplo :generateContent ou :streamGenerateContent.
POST	/v1/models/*	O mesmo formato de requisição do Gemini sob /v1, para clientes que não podem alterar o prefixo de versão da API.
POST	/v1/engines/:model/embeddings	Embeddings do Gemini pelo caminho legado engines.

Kling nativo

repasse

Aceita o corpo de requisição oficial do Kling (model_name + prompt e os campos próprios do provedor) e retorna o formato de tarefa dele.

POST	/kling/v1/videos/text2video	Envia uma tarefa de texto para vídeo do Kling no formato de corpo do próprio provedor.
POST	/kling/v1/videos/image2video	Envia uma tarefa de imagem para vídeo do Kling.
GET	/kling/v1/videos/text2video/:task_id	Consulta uma tarefa de texto para vídeo do Kling.
GET	/kling/v1/videos/image2video/:task_id	Consulta uma tarefa de imagem para vídeo do Kling.

Jimeng nativo

repasse

A API oficial de consulta por Action do Jimeng. Envio e resultado compartilham um caminho e são escolhidos pelo parâmetro Action.

POST	/jimeng/?Action=CVSync2AsyncSubmitTask&Version=2022-08-31	Envia uma tarefa com req_key e prompt no corpo do provedor. A barra final é obrigatória — /jimeng redireciona, e um 301 descarta o corpo na maioria dos clientes HTTP.
POST	/jimeng/?Action=CVSync2AsyncGetResult&Version=2022-08-31	Busca o resultado de uma tarefa enviada.

Suno nativo

repasse

Envio e consulta de música no formato da Suno. Prefira /v1/music/generations para novos projetos — ele retorna o formato de tarefa da plataforma usado em todo o resto.

POST	/suno/submit/:action	action é music ou lyrics.
POST	/suno/fetch	Consulta em lote por lista de ids.
GET	/suno/fetch/:id	Consulta uma tarefa.

gemini-native.sh

# Google GenAI SDK: set the API endpoint, keep everything else.
curl "https://www.aisplice.store/v1beta/models/gemini-3.5-flash:generateContent" \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "Say hello."}]}]
  }'

As respostas de repasse são do provedor, não nossas

Códigos de status, corpos de erro e nomes de campos nestas rotas seguem o provedor upstream. O envelope de erro da plataforma e os códigos de erro documentados valem apenas para rejeições do lado do gateway, como autenticação, cota e roteamento.

#Rotas legadas congeladas

Roteadas e cobradas, mas fechadas a mudanças: sem novos parâmetros, sem garantia de novos modelos e sem promessa de compatibilidade além do que funciona hoje.

Aliases legados

congelado

Ainda roteados e cobrados, mas congelados: sem novos parâmetros e sem promessa de compatibilidade. Migre quando mexer no código que faz a chamada.

POST	/v1/completions	Completion de prompt legado da OpenAI. Use /v1/chat/completions.
POST	/v1/edits	Apesar do nome, é roteado para o formato de edição de imagem. Use /v1/images/edits.
POST	/v1/video/generations	Envio de vídeo anterior ao formato da OpenAI. Use POST /v1/videos.
GET	/v1/video/generations/:task_id	Consulta de vídeo anterior ao formato da OpenAI. Use GET /v1/videos/{task_id}.

Arquivo do Midjourney

congelado

Somente leitura. O envio pago para o Midjourney foi descontinuado; resta apenas consultar as tarefas históricas e as imagens arquivadas.

GET	/mj/task/:id/fetch	Consulta uma tarefa arquivada.
GET	/mj/task/:id/image-seed	Lê a seed de uma imagem arquivada.
GET	/mj/image/:id	Serve uma imagem arquivada.

#O que retorna 404

Interfaces da OpenAI não suportadas simplesmente não são registradas. Um 404 em um caminho da OpenAI significa que o recurso realmente não é oferecido aqui — não é uma lacuna temporária, e não existe rota que responda 501 para fingir o contrário.

Descobrindo o que uma chave realmente pode acessar

GET /v1/models lista todos os modelos que esta chave pode chamar. Combine isso com um 404 no próprio caminho e você consegue diferenciar "modelo não permitido" de "endpoint não oferecido".

Ainda com problemas?

Envie para nós o ID da requisição ou a mensagem de erro e vamos investigar.

AnteriorCobrança e saldo PróximoAntes de entrar em produção