Sora 2 API

Bygg på toppen av Sora 2 API

Lever tekst-til-video-opplevelser støttet av OpenAI Sora 2 og Sora Pro. Autentiser med API-nøkler, poll oppgave-status og lever endelige videoer på minutter.

Hvorfor team stoler på Sora 2 API

Lever robuste videogenereringsarbeidsflyter med forutsigbar spørring, 20 samtidige forespørsler og automatiske lagringsopplastinger.

Sora 2 + Sora Pro

Velg modellstrengen som passer dine kvalitets- og kostnadsbehov: sora-2 eller sora-2-pro.

Forutsigbar polling

Opprett en oppgave, og poll deretter sjekk-resultat-endepunktet for å holde status og fremdrift synkronisert uten SSE.

20 samtidige forespørsler

Behandle opptil 20 videogenereringsoppgaver samtidig. Kontakt oss for høyere grenser.

Autentisering & Basis-URL

Alle endepunkter ligger under https://freesoragenerator.com/api. Oppgi API-nøkkelen som ble opprettet i konsollen via Authorization-headeren.

  • Send headeren Authorization: Bearer YOUR_API_KEY med hver forespørsel.
  • Bruk Content-Type: application/json når du sender pakker.
  • Hver genereringsforespørsel trekker 20 kreditter (sora-2) eller 30 kreditter (sora-2-pro); mislykkede jobber refunderes automatisk.

Kjerneendepunkter

Start med å opprette en genereringsoppgave, og poll deretter eller lytt etter resultatet.

Opprett Sora 2 video

Start en Sora 2 eller Sora Pro genereringsjobb med tekst-til-video eller valgfrie bilde-til-video forespørsel.

Metode: POSTSti: /api/v1/video/sora-video

Pakkeparametere

  • Obligatorisk. Bruk "sora-2" eller "sora-2-pro" for å målrette modellvarianten du trenger.
  • Obligatorisk. Naturlig språkbeskrivelse av scenen du ønsker at Sora skal lage.
  • Valgfritt (anbefalt). Base64-data-URL med prefiks "data:image/*;base64," for bilde-til-video-modus.
  • Valgfritt. Eldre referansebilde-URL; fortsatt støttet, men lavere prioritet enn imageData.
  • Valgfritt. Støttede verdier: "9:16" (standard) eller "16:9".
  • Valgfritt. Om videoen skal vises offentlig; standard er true.
  • Valgfritt (kun VIP). Målvideo-pid for fortsettelse/remix-funksjoner.
  • Valgfritt (kun VIP). Karakterkontrollarray; hvert element inkluderer url og tidsstempler.
  • Valgfritt. HTTPS-endepunkt som mottar den endelige resultatpakken når oppgaven lykkes.

Notater

  • Svar returneres umiddelbart med en taskId; poll sjekk-resultat til status er lykkes eller mislyktes.
  • Gi webHook for å motta den endelige pakken asynkront uten å kjøre en polling-løkke.

Eksempel forespørsel

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
  }'

Eksempel respons

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

Sjekk genereringsresultat

Poll den nyeste statusen for en genereringsoppgave for å spore fremdrift og hente resultater.

Metode: POSTSti: /api/video-generations/check-result

Pakkeparametere

  • Obligatorisk. Identifikatoren som ble returnert da du opprettet genereringsoppgaven.

Notater

  • Endepunktet verifiserer at oppgaven tilhører kontoen din før det returnerer data.
  • Mislykkede jobber returnerer kreditter automatisk og eksponerer refusjonsmetadata i svaret.

Eksempel forespørsel

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"
  }'

Eksempel respons

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

Hent brukerkreditter og VIP-status

Spør om gjeldende brukers tilgjengelige kreditter og VIP-medlemskapsstatus.

Metode: POSTSti: /api/get-user-credits

Notater

  • Krever en gyldig påloggingsøkt eller API-token for å få tilgang til brukerinformasjon.
  • Returnerer feltene left_credits, is_recharged, is_pro og is_vip status.

Eksempel forespørsel

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

Eksempel respons

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

1. Opprett oppgaven

Send Sora2 API-forespørselen med forespørselen din og valgfritt webhook-URL, og lagre den returnerte taskId.

2. Spor fremdrift

Abonner på strømmehendelsene eller kall sjekk-resultat-endepunktet til statusen blir lykkes eller mislyktes.

3. Lever videoen

Bruk de lagringsstøttede URL-ene i result_url/result_urls for å servere eller laste ned den genererte videoen.

Ofte stilte spørsmål

Hvordan autentiserer jeg forespørslene mine?

Opprett en API-nøkkel i konsollen, og inkluder den deretter som Authorization: Bearer YOUR_API_KEY. Nøkler kan roteres når som helst.

Hvordan skal jeg pollere etter resultater?

Etter å ha kalt opprett, lagre taskId. Kall /api/video-generations/check-result hvert 3-5 sekund til status er lykkes eller mislyktes, og bruk deretter result_url/result_urls.

Hvordan håndteres kreditter for feil?

Vi refunderer automatisk kreditter når en oppgave mislykkes og returnerer refund_trans_no pluss credits_refunded=true i sjekk-resultatpakken for revisjonsspor.

Nyttige ressurser

Start med Sora2 API i dag

Opprett API-nøkkelen din og begynn å generere kinoklare AI-videoer på minutter.