TikdekTikdek
Entrega assíncrona

Tarefas de vídeo confiáveis com status e webhooks

Use polling em clientes simples ou webhooks para entrega automática com o mesmo ciclo.

Gerar chave de APILeia documentos
Criar tarefa com webhook
curl -X POST https://sora2-api.com/api/v1/video/sora-video \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2",
    "prompt": "A tracking shot through a quiet night market",
    "aspectRatio": "16:9",
    "webHook": "https://api.example.com/webhooks/video",
    "isPublic": false
  }'

# Your webhook receives a terminal payload:
{
  "id": "task_123",
  "status": "succeeded",
  "progress": 100,
  "results": [{ "url": "https://storage.example/video.mp4" }]
}

Um ciclo de vida, duas formas de entrega

Armazene cada ID e trate succeeded e failed como os únicos estados finais.

Pesquisa previsível

Crie uma tarefa e, em seguida, pesquise o endpoint do resultado da verificação para manter o status e o progresso sincronizados sem SSE.

20 solicitações simultâneas

Processe até 20 tarefas de geração de vídeo simultaneamente. Contate-nos para limites mais altos.

Faturamento transparente

Cada chamada custa 100 créditos por 10s sora-2/sora-2-stable, 150 créditos por 15s sora-2/sora-2-stable ou 150 créditos por sora-2-pro, com reembolso automático quando uma geração falha.

Fluxo de integração recomendado

Regras de entrega do webhook

Responda 2xx rápido, processe de forma idempotente e mantenha polling como recuperação.

Crie a tarefa

Envie a solicitação da Tikdek com seu prompt e armazene o taskId retornado.

Acompanhe o progresso

Chame o endpoint de resultado de verificação até que o status seja bem-sucedido ou com falha.

Entregue o vídeo

Use os URLs com armazenamento em result_url/result_urls para veicular ou baixar o vídeo gerado.

Perguntas frequentes

Como posso autenticar minhas solicitações?

Crie uma chave de API no console e inclua-a como Autorização: Bearer YOUR_API_KEY. As chaves podem ser giradas a qualquer momento.

Como devo pesquisar os resultados?

Após chamar create, armazene o taskId. Chame /api/video-generations/check-result a cada 3-5 segundos até que o status seja bem-sucedido ou falhe e, em seguida, use result_url/result_urls.

Como os créditos são tratados em caso de falhas?

Reembolsamos automaticamente os créditos quando uma tarefa falha e retornamos refund_trans_no mais credits_refunded=true na carga útil do resultado da verificação para trilhas de auditoria.

Entregue geração assíncrona resiliente

Comece com polling e adicione webhooks sem alterar o contrato de geração.

Vá para o console da APIVer preços