Guia de migração

Planeje o futuro após o Sora 2

Mantenha o produto estável com contrato neutro, arquivos próprios e modelos alternativos testados.

Uma requisição neutra de fornecedor
type VideoGenerationRequest = {
  prompt: string;
  imageUrl?: string;
  aspectRatio: "16:9" | "9:16";
  durationSeconds: number;
  quality: "standard" | "high";
  callbackUrl?: string;
};

type VideoGenerationResult = {
  id: string;
  status: "queued" | "running" | "succeeded" | "failed";
  progress: number;
  outputUrl?: string;
  errorCode?: string;
};

interface VideoProvider {
  create(input: VideoGenerationRequest): Promise<{ id: string }>;
  retrieve(id: string): Promise<VideoGenerationResult>;
}

Separe seu produto do modelo

Normalize entradas, status, erros e URLs antes do código específico do fornecedor.

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.

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.

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.

Fluxo de integração recomendado

Prazo de migração

A OpenAI planeja encerrar Sora 2 e Videos API em 24 de setembro de 2026. Valide uma alternativa.

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.

Torne a próxima troca de modelo rotineira

Mantenha endpoints estáveis e isole a escolha do fornecedor em um adaptador substituível.