API Sora 2

Construa com base na API Sora 2

Envie experiências de texto para vídeo apoiadas por OpenAI Sora 2 e Sora Pro. Autentique com chaves de API, pesquise o status da tarefa e entregue os vídeos finais em minutos.

Por que as equipes confiam na API Sora 2

Forneça fluxos de trabalho resilientes de geração de vídeo com pesquisas previsíveis, 20 solicitações simultâneas e uploads automáticos de armazenamento.

Sora 2 + Estável + Pro

Escolha o modelo que corresponda às suas necessidades de qualidade e custo: sora-2, sora-2-stable ou sora-2-pro.

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.

Autenticação e URL base

Todos os endpoints residem em https://sora2-api.com/api. Forneça a chave API criada no console por meio do cabeçalho Authorization.

  • Envie o cabeçalho Authorization: Bearer YOUR_API_KEY com cada solicitação.
  • Use Content-Type: application/json ao postar cargas úteis.
  • Cada solicitação de geração deduz créditos com base no modelo e duração: sora-2/sora-2-stable 10s (100) ou 15s (150), sora-2-pro (150); trabalhos com falha são reembolsados ​​automaticamente.

Pontos de extremidade principais

Comece criando uma tarefa de geração e, em seguida, pesquise ou ouça o resultado.

Criar vídeo Sora 2

Inicie um trabalho de geração Sora 2 ou Sora Pro com mensagens de texto para vídeo ou de imagem para vídeo opcionais.

Método: POSTCaminho: /api/v1/video/sora-video

Parâmetros de carga útil

  • model: Obrigatório. Use "sora-2", "sora-2-stable" ou "sora-2-pro".
  • prompt: Obrigatório. Descrição em linguagem natural da cena que você deseja que Sora crie.
  • imageData: Opcional (recomendado). URL de dados Base64 com prefixo "data:image/*;base64," para modo imagem para vídeo.
  • url: Optional. Legacy reference image URL; still supported but lower priority than imageData.
  • aspectRatio: Opcional. Valores suportados: "9:16" (padrão) ou "16:9".
  • isPublic: Opcional. Se o vídeo deve ser exibido publicamente; o padrão é verdadeiro.
  • remixTargetId: Opcional (somente VIP). Alvo pid de vídeo para recursos de continuação/remix.
  • characters: Opcional (somente VIP). Matriz de controle de caracteres; cada item inclui URL e carimbos de data/hora.

Notas

  • As respostas retornam imediatamente com um taskId; resultado da verificação da pesquisa até que o status seja bem-sucedido ou falhe.

Solicitação de amostra

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-pro",
    "prompt": "A cinematic shot of a futuristic city at sunset, captured in 4K.",
    "imageData": "data:image/png;base64,iVBORw0KGgoAAA...",
    "aspectRatio": "9:16",
    "isPublic": true
  }'

Exemplo de resposta

{
  "code": 0,
  "message": "ok",
  "data": {
    "id": "task_1234567890"
  }
}

Verifique o resultado da geração

Pesquise o status mais recente de uma tarefa de geração para acompanhar o progresso e recuperar resultados.

Método: POSTCaminho: /api/video-generations/check-result

Parâmetros de carga útil

  • taskId: Obrigatório. O identificador retornado quando você criou a tarefa de geração.

Notas

  • O endpoint verifica se a tarefa pertence à sua conta antes de retornar os dados.
  • Os trabalhos com falha retornam créditos automaticamente e expõem metadados de reembolso na resposta.

Solicitação de amostra

curl -X POST https://sora2-api.com/api/video-generations/check-result \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskId": "task_1234567890"
  }'

Exemplo de resposta

{
  "code": 0,
  "message": "Success",
  "data": {
    "status": "running",
    "progress": 35,
    "result_url": "https://your-domain.com/storage/videos/xxx.mp4",
    "result_urls": [
      "https://your-domain.com/storage/videos/xxx.mp4"
    ],
    "failure_reason": "",
    "error_message": null,
    "credits_refunded": false,
    "refund_trans_no": null,
    "result_pid": "s_xxx",
    "result_pids": [
      "s_xxx"
    ],
    "metadata": {
      "remixTargetId": "s_prev",
      "characters": [
        {
          "url": "https://.../hero.mp4",
          "timestamps": "0,3"
        }
      ]
    }
  }
}

Obtenha créditos de usuário e status VIP

Consulte os créditos disponíveis do usuário atual e o status da associação VIP.

Método: POSTCaminho: /api/get-user-credits

Notas

  • Requer sessão de login válida ou token de API para acessar informações do usuário.
  • Retorna os campos de status left_credits, is_recharged, is_pro e is_vip.

Solicitação de amostra

curl -X POST https://sora2-api.com/api/get-user-credits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Exemplo de resposta

{
  "code": 0,
  "message": "ok",
  "data": {
    "left_credits": 120,
    "is_recharged": true,
    "is_pro": true,
    "is_vip": false
  }
}

1. Crie a tarefa

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

2. Acompanhe o progresso

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

3. 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.

Recursos úteis

Lance com Tikdek hoje

Crie sua chave de API e comece a gerar vídeos cinematográficos de IA em minutos.