Руководство Python

AI API изображения в видео на Python

Создайте задачу из изображения, безопасно отслеживайте её и загрузите готовое видео.

Python: создать, проверить, загрузить
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")

Полный цикл запроса на Python

Пример использует рабочие endpoints Tikdek и обрабатывает все конечные состояния.

Сора 2 + Стабильный + Про

Выберите модельную цепочку, которая соответствует вашим требованиям по качеству и стоимости: sora-2, sora-2-stable или sora-2-pro.

Предсказуемый опрос

Создайте задачу, а затем опросите конечную точку результатов проверки, чтобы синхронизировать состояние и прогресс без SSE.

20 одновременных запросов

Обрабатывайте до 20 задач по созданию видео одновременно. Свяжитесь с нами для более высоких лимитов.

Рекомендуемый порядок интеграции

Подготовьте интеграцию к продакшену

Храните ключи на сервере, ограничьте повторы, журналируйте ID и быстро сохраняйте результаты.

Создайте задачу

Отправьте запрос Tikdek с приглашением, а затем сохраните возвращенный идентификатор задачи.

Отслеживайте прогресс

Вызывайте конечную точку результата проверки до тех пор, пока статус не станет успешным или неудачным.

Доставьте видео

Используйте URL-адреса, сохраненные в хранилище, в result_url/result_urls для показа или загрузки сгенерированного видео.

Часто задаваемые вопросы

Как мне подтвердить свои запросы?

Создайте ключ API в консоли, затем включите его в качестве авторизации: предъявитель YOUR_API_KEY. Ключи можно поворачивать в любое время.

Как я должен опросить результаты?

После вызова create сохраните идентификатор задачи. Вызывайте /api/video-generations/check-result каждые 3–5 секунд, пока статус не будет успешным или неудачным, затем используйте result_url/result_urls.

Как распределяются кредиты в случае неудач?

Мы автоматически возвращаем кредиты в случае сбоя задачи и возвращаем return_trans_no плюс Credits_refunded=true в полезных данных результатов проверки для контрольного журнала.

От скрипта к продакшену

Создайте ключ, запустите пример и добавьте webhook при росте нагрузки.