Gratis Sora GeneratorSora2 Web
Sora 2 Pro API

Integrer Sora 2 Pro API-en

Bygg tekst-til-video, bilde-til-video og storyboard-arbeidsflyter med forutsigbar polling og kredittkontroll.

Generer API-nøkkelSe priser

Hva Sora 2 Pro API-en leverer

Alt du trenger for å lansere produksjonsklare Sora 2 Pro-pipelines.

Fem modellvarianter

Velg sora-2 tekst/bilde eller sora-2-pro tekst/bilde/storyboard basert på kvalitet og kostnad.

Storyboard-støtte

Definer fortellinger med flere scener med shots[] og varighet per scene.

Enhetlige svar

Alle endepunkter returnerer code/message/data, selv når HTTP-status er 200 ved feil.

Autentisering og basis-URL

Basis-URL: https://freesoragenerator.com. Autentiser med en API-nøkkel eller en innlogget øktkapsel.

  • Authorization: Bearer [TOKEN] (API-nøkkel sk- eller JWT), eller send en øktkapsel.
  • Send Content-Type: application/json med POST-kropper.
  • De fleste feil returnerer fortsatt HTTP 200; inspiser alltid code-feltet.

Kjerneendepunkter

Opprett oppgaver med /sora-pro, deretter poll check-result for status.

Opprett genereringsoppgave

Valider input, trekk fra kreditter, opprett en oppgave og returner taskId.

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

Payload-parametere

  • Påkrevd. En av sora-2-text-to-video, sora-2-image-to-video, sora-2-pro-text-to-video, sora-2-pro-image-to-video, sora-2-pro-storyboard.
  • Betinget. Påkrevd for alle modeller unntatt sora-2-pro-storyboard.
  • Betinget. Base64 data-URL som data:image/png;base64,... Påkrevd for bilde-til-video hvis ingen imageUrl.
  • Betinget. Offentlig bilde-URL brukt når imageData ikke er oppgitt.
  • Valgfritt. portrait eller landscape. Standard: landscape.
  • Valgfritt. 10, 15 eller 25 (kun storyboard). Standardverdier varierer per modell.
  • Valgfritt. standard eller high. Kun for Pro tekst/bilde-modeller.
  • Valgfritt. Fjern vannmerke for ikke-storyboard-modeller. Standard: true.
  • Betinget. Påkrevd for sora-2-pro-storyboard. Array av '{ Scene, duration }'.

Merknader

  • imageData har prioritet over imageUrl når begge er oppgitt.
  • prompt er valgfritt for storyboard og sendes ikke til leverandøren; bruk shots for innhold.
  • nFrames normaliseres til tillatte verdier per modell.
  • removeWatermark er standard true for ikke-storyboard-modeller.
  • shots må inkludere Scene (stor S) og duration > 0.

Eksempelforespørsler

Tekst-til-video
curl -X POST https://freesoragenerator.com/api/v1/video/sora-pro \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2-pro-text-to-video",
    "prompt": "A cinematic shot of a futuristic city at sunset.",
    "aspectRatio": "landscape",
    "nFrames": "10",
    "size": "high",
    "removeWatermark": true
  }'
Bilde-til-video
curl -X POST https://freesoragenerator.com/api/v1/video/sora-pro \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2-image-to-video",
    "prompt": "Turn this image into a dynamic 10s clip.",
    "imageUrl": "https://example.com/reference.png",
    "aspectRatio": "portrait",
    "nFrames": "10"
  }'
Storyboard
curl -X POST https://freesoragenerator.com/api/v1/video/sora-pro \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2-pro-storyboard",
    "shots": [
      { "Scene": "Establishing shot of a city skyline at dusk", "duration": 5 },
      { "Scene": "Close-up of a runner splashing through puddles", "duration": 5 }
    ],
    "aspectRatio": "landscape",
    "nFrames": "10"
  }'

Eksempelsvar

{
  "code": 0,
  "message": "ok",
  "data": {
    "taskId": "281e5b0*********************f39b9"
  }
}

Spør etter oppgavestatus

Hent status, fremdrift og resultat-URL-er etter taskId.

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

Payload-parametere

  • Påkrevd. taskId returnert av create.

Merknader

  • Statusverdier: pending | running | succeeded | failed | cancelled.
  • result_url og result_urls returnerer de endelige videolenkene når de er klare.

Eksempelforespø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": "281e5b0*********************f39b9"
  }'

Eksempelsvar

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

Hent brukerkreditter

Sjekk gjeldende kredittsaldo før du sender inn oppgaver.

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

Merknader

  • Valgfritt endepunkt; nyttig for forhåndssjekker.
  • Returnerer left_credits og is_vip-flagg.

Eksempelforespørsel

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

Eksempelsvar

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

Vanlige feilkoder

Feil vises gjennom code-feltet i svarkroppen.

  • 401: Uautorisert
  • 402: Utilstrekkelige kreditter
  • -1: Ugyldig modellparameter
  • -1: Prompt er påkrevd
  • -1: Bilde er påkrevd for bilde-til-video
  • -1: Shots er påkrevd for storyboard
  • -1: Kunne ikke laste opp bilde
  • -1: Kunne ikke opprette videogenereringspost

Kredittreferanse

Kreditter varierer etter modell, størrelse og nFrames. Bruk denne tabellen som utgangspunkt.

ModellParametereKreditter
sora-2-text-to-video1020
sora-2-text-to-video1530
sora-2-image-to-video1020
sora-2-image-to-video1530
sora-2-pro-text-to-videostandard + 10375
sora-2-pro-text-to-videostandard + 15675
sora-2-pro-text-to-videohigh + 10825
sora-2-pro-text-to-videohigh + 151 575
sora-2-pro-image-to-videostandard + 10375
sora-2-pro-image-to-videostandard + 15675
sora-2-pro-image-to-videohigh + 10825
sora-2-pro-image-to-videohigh + 151 575
sora-2-pro-storyboard10375
sora-2-pro-storyboard15675
sora-2-pro-storyboard25675

1. Opprett oppgaven

POST /api/v1/video/sora-pro med din modell og payload.

2. Spor fremdrift

Poll /api/video-generations/check-result til statusen er succeeded eller failed.

3. Verifiser kreditter

Kall eventuelt /api/get-user-credits før du sender inn store partier.

Ofte stilte spørsmål

Kan jeg bruke API-nøkler eller øktkapsler?

Ja. Send Authorization: Bearer [TOKEN] (API-nøkkel eller JWT) eller en innlogget øktkapsel.

Hvordan formaterer jeg storyboard-scener?

Oppgi shots som en array av '{ Scene, duration }' der Scene har stor forbokstav og duration er sekunder.

Hvorfor varierer kreditter etter modell?

Kreditter skalerer med nFrames for alle modeller; Pro-modeller varierer også etter størrelse.

Nyttige ressurser

API-nøkkelkonsoll

Opprett, roter og tilbakekall API-nøkler for integrasjonene dine.

Priser

Se kredittforbruk og påfyllingsalternativer.

Kontakt support

Trenger du høyere grenser eller tilpassede kontrakter? Send e-post til support@freesoragenerator.com.

Kom i gang med Sora 2 Pro API-en

Generer en API-nøkkel og start din første Sora 2 Pro-arbeidsflyt i dag.

Gå til API-konsollSe priser