Guia Python

API de imagem para vídeo com Python

Crie uma tarefa a partir de uma imagem, acompanhe o status e baixe o vídeo final.

Python: criar, consultar e baixar
import os
import time
import requests

base_url = "https://sora2-api.com"
headers = {
    "Authorization": f"Bearer {os.environ['TIKDEK_API_KEY']}",
    "Content-Type": "application/json",
}

created = requests.post(
    f"{base_url}/api/v1/video/sora-video",
    headers=headers,
    json={
        "model": "sora-2-pro",
        "prompt": "Slow camera push-in, rain moving across the frame",
        "url": "https://example.com/reference-frame.jpg",
        "aspectRatio": "16:9",
        "webHook": "-1",
        "isPublic": False,
    },
    timeout=30,
)
created.raise_for_status()
task_id = created.json()["data"]["id"]

for _ in range(90):
    response = requests.post(
        f"{base_url}/api/video-generations/check-result",
        headers=headers,
        json={"taskId": task_id},
        timeout=30,
    )
    response.raise_for_status()
    task = response.json()["data"]

    if task["status"] == "succeeded":
        video = requests.get(task["result_url"], timeout=120)
        video.raise_for_status()
        open("result.mp4", "wb").write(video.content)
        break

    if task["status"] == "failed":
        raise RuntimeError(task.get("error_message") or "Generation failed")

    time.sleep(4)
else:
    raise TimeoutError(f"Task {task_id} did not finish in time")

Um ciclo completo de requisição em Python

O exemplo usa os endpoints reais do Tikdek e trata todos os estados finais.

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.

Fluxo de integração recomendado

Prepare a integração para produção

Mantenha chaves no servidor, limite tentativas, registre IDs e salve os resultados rapidamente.

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.

Do script para produção

Crie uma chave, execute o exemplo e adicione webhook quando o volume aumentar.