Sora 2 API

Buduj na bazie API Sora 2

Wysyłaj doświadczenia tekst-na-wideo wspierane przez OpenAI Sora 2 i Sora Pro. Uwierzytelnij się za pomocą kluczy API, sprawdzaj status zadań i dostarczaj finalne filmy w ciągu kilku minut.

Dlaczego zespoły polegają na API Sora 2

Dostarczaj odporne przepływy pracy generacji wideo z przewidywalnym pollingiem, 20 równoczesnymi żądaniami i automatycznymi przesyłkami do pamięci.

Sora 2 + Sora Pro

Wybierz ciąg modelu, który odpowiada Twoim potrzebom jakościowym i kosztowym: sora-2 lub sora-2-pro.

Przewidywalne polling

Utwórz zadanie, a następnie sprawdzaj punkt końcowy sprawdzania wyników, aby utrzymać status i postęp w synchronizacji bez SSE.

20 równoczesnych żądań

Przetwarzaj do 20 zadań generowania wideo jednocześnie. Skontaktuj się z nami w sprawie wyższych limitów.

Uwierzytelnianie i podstawowy URL

Wszystkie punkty końcowe znajdują się pod https://freesoragenerator.com/api. Podaj klucz API utworzony w konsoli za pomocą nagłówka Authorization.

  • Wyślij nagłówek Authorization: Bearer YOUR_API_KEY z każdym żądaniem.
  • Użyj Content-Type: application/json podczas przesyłania ładunków.
  • Każde żądanie generacji odejmuje 20 kredytów (sora-2) lub 30 kredytów (sora-2-pro); nieudane zadania są automatycznie zwracane.

Podstawowe punkty końcowe

Zacznij od utworzenia zadania generacji, a następnie sprawdzaj lub nasłuchuj wyniku.

Utwórz wideo Sora 2

Rozpocznij zadanie generacji Sora 2 lub Sora Pro z podpowiedziami tekst-na-wideo lub opcjonalnymi obraz-na-wideo.

Metoda: POSTŚcieżka: /api/v1/video/sora-video

Parametry ładunku

  • Wymagane. Użyj "sora-2" lub "sora-2-pro", aby celować w potrzebną wersję modelu.
  • Wymagane. Opis w języku naturalnym sceny, którą chcesz, aby Sora stworzyła.
  • Opcjonalne (zalecane). URL danych Base64 z prefiksem "data:image/*;base64," dla trybu obraz-na-wideo.
  • Opcjonalne. Starszy URL obrazu referencyjnego; nadal obsługiwany, ale o niższym priorytecie niż imageData.
  • Opcjonalne. Obsługiwane wartości: "9:16" (domyślnie) lub "16:9".
  • Opcjonalne. Czy wyświetlać wideo publicznie; domyślnie true.
  • Opcjonalne (tylko VIP). Docelowy pid wideo dla funkcji kontynuacji/remiksu.
  • Opcjonalne (tylko VIP). Tablica kontroli postaci; każdy element zawiera url i znaczniki czasu.
  • Opcjonalne. Punkt końcowy HTTPS, który otrzymuje ostateczny ładunek wynikowy, gdy zadanie się powiedzie.

Uwagi

  • Odpowiedzi zwracają natychmiastowo z taskId; sprawdzaj check-result, aż status będzie zakończony lub niepowodzenie.
  • Podaj webHook, aby otrzymać ostateczny ładunek asynchronicznie bez uruchamiania pętli polling.

Przykładowe żądanie

curl -X POST https://freesoragenerator.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
  }'

Przykładowa odpowiedź

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

Sprawdź wynik generacji

Sprawdzaj najnowszy status zadania generacji, aby śledzić postęp i uzyskać wyniki.

Metoda: POSTŚcieżka: /api/video-generations/check-result

Parametry ładunku

  • Wymagane. Identyfikator zwrócony, gdy utworzyłeś zadanie generacji.

Uwagi

  • Punkt końcowy weryfikuje, że zadanie należy do Twojego konta przed zwróceniem danych.
  • Nieudane zadania automatycznie zwracają kredyty i ujawniają metadane zwrotu w odpowiedzi.

Przykładowe żądanie

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

Przykładowa odpowiedź

{
  "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"
        }
      ]
    }
  }
}

Pobierz kredyty użytkownika i status VIP

Zapytaj o dostępne kredyty bieżącego użytkownika i status członkostwa VIP.

Metoda: POSTŚcieżka: /api/get-user-credits

Uwagi

  • Wymaga ważnej sesji logowania lub tokenu API, aby uzyskać dostęp do informacji o użytkowniku.
  • Zwraca pola left_credits, is_recharged, is_pro i is_vip statusu.

Przykładowe żądanie

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

Przykładowa odpowiedź

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

1. Utwórz zadanie

Wyślij żądanie API Sora2 z podpowiedzią i opcjonalnym adresem URL webhook, a następnie zapisz zwrócone taskId.

2. Śledź postęp

Subskrybuj zdarzenia strumieniowe lub wywołuj punkt końcowy check-result, aż status stanie się zakończony lub niepowodzenie.

3. Dostarcz wideo

Użyj adresów URL opartych na pamięci w result_url/result_urls, aby serwować lub pobierać wygenerowane wideo.

Najczęściej zadawane pytania

Jak uwierzytelnić moje żądania?

Utwórz klucz API w konsoli, a następnie dołącz go jako Authorization: Bearer YOUR_API_KEY. Klucze można rotować w dowolnym momencie.

Jak powinienem sprawdzać wyniki?

Po wywołaniu create, zapisz taskId. Wywołuj /api/video-generations/check-result co 3-5 sekund, aż status będzie zakończony lub niepowodzenie, a następnie użyj result_url/result_urls.

Jak są obsługiwane kredyty w przypadku niepowodzeń?

Automatycznie zwracamy kredyty, gdy zadanie się nie powiedzie i zwracamy refund_trans_no oraz credits_refunded=true w ładunku check-result dla śladów audytowych.

Przydatne zasoby

Uruchom z API Sora2 już dziś

Utwórz swój klucz API i zacznij generować filmowe wideo AI w ciągu kilku minut.