GPT-Image 2.6 Flare e Sunburst chegaramA partir de $0.025 por imagem
OmniaKey
Faça login

Configuração da chave de API

Chave de API Seedance: obter, configurar e testar

Antes de configurar sua chave de API Seedance, escolha quem a emite. Combine a chave, a URL da API e o ID do modelo. As etapas abaixo configuram o acesso pela OmniaKey.

Chave oficial do provedor

Para uma chave emitida e cobrada diretamente pela ByteDance, siga as instruções de conta e chave de API do próprio provedor.

Abrir instruções da chave oficial

Chave de API OmniaKey

Use um único saldo e uma única chave OmniaKey para os modelos disponíveis na sua conta. A chave funciona com o endpoint OmniaKey.

Obter uma chave de API

01Crie uma chave de API OmniaKey

Entre na conta, abra Chaves de API e crie uma chave para sua aplicação. Revise a cota, a validade e as restrições de modelos. Adicione saldo antes de executar pedidos de geração.

Obter uma chave de API

02Defina a chave e a URL da API

Execute os comandos no seu próprio terminal e substitua o espaço reservado pela sua chave. Mantenha a chave no servidor ou em um gerenciador de segredos. Nunca a coloque em código de navegador ou em um repositório público.

bash / zsh
export OMNIAKEY_API_KEY="YOUR_OMNIAKEY_API_KEY"
export OMNIAKEY_BASE_URL="https://api.omniakey.com/v1"

03Verifique a autenticação

Solicite a lista de modelos sem iniciar uma tarefa de geração. Uma resposta bem-sucedida é um JSON com um array data. Isso verifica o acesso da chave; não confirma que todos os modelos estão habilitados para sua conta.

GET /v1/models
curl --fail-with-body "$OMNIAKEY_BASE_URL/models" \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY"

04Use o formato de requisição do modelo

Selecione um modelo na página da família, copie o ID da API e siga a documentação correspondente. A autenticação sozinha não verifica seus parâmetros de geração.

A geração de imagem e vídeo usa POST /v1/media/tasks. Mantenha a mesma Idempotency-Key ao repetir o mesmo envio, salve o ID da tarefa retornado e consulte GET /v1/media/tasks/{id} para obter o resultado.

Exemplo de pedido de geração (cobrado)

Este pedido usa o saldo da sua conta. Confira antes o preço do modelo escolhido. O exemplo segue o formato de requisição documentado; sua conta ainda precisa ter acesso ao modelo.

POST /v1/media/tasks
curl --fail-with-body 'https://api.omniakey.com/v1/media/tasks' \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: seedance-first-request-001" \
  -d '{
  "model": "dreamina-seedance-2-5-260628",
  "type": "video",
  "operation": "text_to_video",
  "input": {
    "prompt": "A paper boat on a quiet lake at sunset."
  },
  "parameters": {
    "duration": 5,
    "resolution": "720P",
    "ratio": "16:9"
  }
}'

Consultar a tarefa de mídia

Substitua YOUR_TASK_ID pelo id retornado no pedido de criação. Consulte até a tarefa chegar a um status final. Para uma tarefa bem-sucedida, baixe as URLs em assets antes de expirarem. Use uma nova chave de idempotência apenas para uma nova tarefa.

GET /v1/media/tasks/{id}
curl --fail-with-body "https://api.omniakey.com/v1/media/tasks/YOUR_TASK_ID" \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY"
Ler a documentação da API

Se a conexão falhar

  • 401: verifique se a chave está completa, ativa e foi emitida para a URL da API que você está chamando.
  • 403: verifique as restrições de modelos da chave e as permissões disponíveis na sua conta.
  • 404 ou HTML em vez de JSON: verifique o host da API e o prefixo de versão. Use api.omniakey.com, não o endereço do site.
  • 429: reduza a concorrência e siga a orientação de nova tentativa da resposta. Não continue reenviando tarefas de geração com novas chaves de idempotência.