TikdekTikdek
Tikdek Video API

Integre a Tikdek Video API

Crie tarefas de vídeo de texto, imagem ou storyboard com /api/v1/video/sora-pro, depois pesquise o status e entregue resultados com verificação de resultado.

Gerar chave de APIVer preços

Tudo que você precisa para entrega do Sora 2 Pro

Uma API cobre fluxos de trabalho Sora 2, Sora 2 Pro e storyboard com faturamento claro e pesquisas previsíveis.

Sete modelos suportados

Escolha entre variantes de texto/imagem Sora 2, texto/imagem estável Sora 2 e texto/imagem/storyboard Sora 2 Pro.

Créditos escalonados

Escala de créditos com duração e qualidade, incluindo padrão/alto para Sora 2 Pro.

Entrega baseada em tarefas

Crie uma tarefa, pesquise o resultado da verificação e envie o result_url final.

Autenticação e URL base

Todos os endpoints são atendidos por https://sora2-api.com. Envie a chave de API do console no cabeçalho de autorização.

  • Incluir Autorização: Portador YOUR_API_KEY em cada solicitação.
  • Use Content-Type: application/json para cargas JSON.
  • As respostas incluem código/mensagem/dados; check-result pode retornar 4xx/5xx, então valide o status HTTP também.

Créditos e cobrança

O faturamento varia de acordo com modelo, duração e nível de qualidade.

  • Texto/imagem Sora 2: 10s = 100 créditos, 15s = 150 créditos.
  • Sora 2 Texto/imagem estável: 10s = 100 créditos, 15s = 150 créditos.
  • Texto/imagem Sora 2 Pro: 10s = 375, 15s = 675.
  • Storyboard do Sora 2 Pro: 10s = 375, 15s = 675, 25s = 875.
  • Os preços acima são finais; os encargos são arredondados.

Pontos de extremidade principais

Comece criando uma tarefa de geração e, em seguida, pesquise ou verifique seu saldo de crédito.

Crie um vídeo Sora 2 Pro

Envie trabalhos de texto, imagem ou storyboard, deduza os créditos imediatamente e receba taskId.

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

Parâmetros de carga útil

  • modelo: Obrigatório. Use uma das strings de modelo suportadas acima.
  • prompt: Obrigatório, exceto para storyboard. Descreva a cena que você deseja gerar.
  • imageData: obrigatório para imagem para vídeo. URL de dados Base64 com prefixo "data:image/*;base64,".
  • imageUrl: Opcional. URL da imagem pública se preferir não enviar base64.
  • AspectRatio: Opcional. "paisagem" ou "retrato" (paisagem padrão).
  • nFrames: Opcional. "10"/"15"/"25" (25 é apenas storyboard).
  • tamanho: Opcional (texto/imagem Pro). "padrão" ou "alto".
  • removeWatermark: Opcional (texto/imagem). Remover sinalizador de marca d'água, padrão verdadeiro.
  • fotos: Obrigatório para storyboard. Matriz de fotos com cena e duração.
  • isPublic: Opcional. Se o resultado for público, o padrão é verdadeiro.

Notas

  • Modelos suportados: sora-2-text-to-video, sora-2-image-to-video, sora-2-text-to-video-stable, sora-2-image-to-video-stable, sora-2-pro-text-to-video, sora-2-pro-image-to-video, sora-2-pro-storyboard.
  • Os créditos são deduzidos no envio; trabalhos com falha são reembolsados ​​automaticamente.
  • O modo Storyboard requer o conjunto de fotos.

Estrutura de tiros

Obrigatório para solicitações de storyboard; cada item define uma cena e duração.

[
  { "scene": "Um café aconchegante ao nascer do sol, luz quente.", "duration": 7.5 }
]
  • cena: Descrição da cena.
  • duração: Segundos (suporta decimais como 7,5).

Solicitação de amostra

curl -X POST https://sora2-api.com/api/v1/video/sora-pro \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2-pro-text-to-video",
    "prompt": "Um rastreamento cinematográfico filmado em um mercado de rua iluminado por neon ao anoitecer.",
    "aspectRatio": "landscape",
    "nFrames": "10",
    "size": "high",
    "removeWatermark": true,
    "isPublic": true
  }'

Exemplo de resposta

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

Verifique o resultado da geração

Pesquise o status da tarefa e sincronize os 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

  • Retorna status, progresso e result_url quando disponível.
  • Pode retornar 4xx/5xx para validação, permissão ou casos não encontrados.

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": {
    "task_id": "task_1234567890",
    "status": "running",
    "progress": 0,
    "result_url": ""
  }
}

Obtenha créditos de usuário

Obtenha os créditos restantes e o status VIP.

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

Notas

  • Requer uma chave ou sessão de API válida.
  • Retorna os campos left_credits 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_vip": true
  }
}

1. Crie a tarefa

Envie /api/v1/video/sora-pro com sua carga útil e armazene o taskId.

2. Acompanhe o progresso

Pesquise /api/video-generations/check-result até que o status seja bem-sucedido ou falhe.

3. Entregue o vídeo

Use result_url/result_urls para distribuir ou armazenar o vídeo gerado.

Perguntas frequentes

Quais modelos são suportados?

Use sora-2-text-to-video ou sora-2-image-to-video; Sora 2 Pro adiciona variantes de texto, imagem e storyboard.

Quais valores o nFrames suporta?

Use “10” ou “15” para todos os modos; "25" é apenas para storyboard. Texto/imagem Pro suporta tamanho padrão ou alto.

Por que o resultado da verificação pode retornar 4xx/5xx?

O endpoint valida a propriedade e a entrada, portanto, tarefas inválidas ou não autorizadas podem retornar 4xx/5xx junto com o código/mensagem.

Recursos úteis

Console de chaves de API

Crie, alterne e revogue chaves de API para suas integrações.

Preços

Revise o consumo de crédito e as opções de recarga antes de lançar.

Teste de API on-line

Experimente os endpoints com nosso playground interativo Apifox.

Contate o suporte

Precisa de um limite de taxa mais alto ou de um contrato personalizado? Entre em contato conosco através de [email protected].

Lançamento com Tikdek Video API

Crie sua chave API e comece a gerar vídeos Sora 2 Pro em minutos.

Vá para o console da APIVer preços