Pular para o conteúdo principal

Integrações

Integre modelos de imagem, vídeo e linguagem selecionados por uma API consistente.

Use chamadas compatíveis com OpenAI para chat e roleplay, ou a API de tarefas para imagens, vídeo e áudio. Escolha um modelo, mantenha a chave no servidor e siga o caminho do resultado que você precisa.

Escolha seu caminho

Uma chave de API, quatro formas de conectar

Comece onde você já trabalha. Todos os caminhos chegam aos mesmos modelos, com os mesmos preços.

Comece em 5 minutos

Sua primeira imagem em quatro passos

Crie uma tarefa, guarde o ID dela e busque o arquivo pronto. O mesmo padrão vale para todo modelo de imagem, vídeo e áudio.

  1. 01

    Escolher modelo

    Comparar tarefa, entradas, política, disponibilidade atual e preço.

  2. 02

    Copiar requisição

    Troque o ID do modelo e o input do exemplo pelos campos exatos que aquela página de modelo mostra. Nunca deduza parâmetros olhando outro modelo.

  3. 03

    Enviar pelo servidor

    HTTP 202 quer dizer que a tarefa foi aceita, não que a geração terminou; o código de negócio do envelope continua code: 200. Salve data.taskId na hora; estimatedCost é o valor reservado para esta tarefa.

  4. 04

    Consultar o status com tentativas limitadas

    queued e running ainda estão em execução; succeeded, failed e expired são estados finais. Pare de consultar em qualquer estado final, em vez de esperar só pelo sucesso.

curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-8814-render-1" \
  -d '{
    "model": "alibaba/z-image-turbo/text-to-image",
    "input": { "prompt": "A ceramic teapot on a linen cloth, soft window light" }
  }'

alibaba/z-image-turbo/text-to-image é um endpoint real de texto para imagem. Ao usar outro modelo de mídia, copie o ID exato e seu schema.

Diretório

Todas as integrações em um só lugar

Escolha a ferramenta que você já usa. Cada card abre o guia de configuração.

Segurança no servidor

Três coisas que produção precisa resolver

Estas três regras cobrem vazamento de chave, cobrança duplicada e perda de tarefa. É o mínimo antes de subir para produção.

Mantenha a chave da API no servidor

Não exponha a chave no navegador, bundle móvel, prompt, log ou saída de agente. Envie requisições por um backend sob seu controle.

Idempotency-Key

Envie uma Idempotency-Key estável em toda solicitação de criação. Se o resultado da rede for incerto, repita o mesmo trabalho com a mesma chave para evitar duas tarefas cobradas.

Acompanhe as tarefas de mídia aceitas

Guarde o taskId e use webhook assinado ou verificações limitadas. Uma tarefa aceita começa e não pode ser cancelada. Tarefas com falha ou tempo esgotado normalmente não são cobradas. Alguns modelos cobram recusas de conteúdo conforme indicado na página do modelo; confira essas condições antes de enviar.

Documentação da API

Abrir a referência que responde sua dúvida