Sora 2 Pro API

Integrer Sora 2 Pro API'en

Byg tekst-til-video, billede-til-video og storyboard-workflows med forudsigelig polling og kreditkontrol.

Hvad Sora 2 Pro API'en leverer

Alt hvad du behøver for at lancere produktionsklare Sora 2 Pro-pipelines.

Fem modelvarianter

Vælg sora-2 tekst/billede eller sora-2-pro tekst/billede/storyboard baseret på kvalitet og pris.

Storyboard-understøttelse

Definer multi-shot-narrativer med shots[] og varighed pr. shot.

Ensartede svar

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

Autentificering & Base URL

Base URL: https://freesoragenerator.com. Autentificer med en API-nøgle eller en logget ind session-cookie.

  • Authorization: Bearer [TOKEN] (API-nøgle sk- eller JWT), eller send en session-cookie.
  • Send Content-Type: application/json med POST-bodies.
  • De fleste fejl returnerer stadig HTTP 200; inspicér altid code-feltet.

Kerne-endpoints

Opret opgaver med /sora-pro, og poll derefter check-result for status.

Opret genereringsopgave

Valider input, træk kreditter, opret en opgave og returner taskId.

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

Payload-parametre

  • Påkrævet. En af 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åkrævet for alle modeller undtagen sora-2-pro-storyboard.
  • Betinget. Base64 data URL som data:image/png;base64,... Påkrævet for image-to-video, hvis ingen imageUrl.
  • Betinget. Offentlig billed-URL, der bruges når imageData ikke er angivet.
  • Valgfri. portrait eller landscape. Standard: landscape.
  • Valgfri. 10, 15 eller 25 (kun storyboard). Standardværdier varierer efter model.
  • Valgfri. standard eller high. Kun for Pro tekst/billede-modeller.
  • Valgfri. Fjern vandmærke for ikke-storyboard-modeller. Standard: true.
  • Betinget. Påkrævet for sora-2-pro-storyboard. Array af '{ Scene, duration }'.

Noter

  • imageData har forrang over imageUrl, når begge er angivet.
  • prompt er valgfri for storyboard og sendes ikke til udbyderen; brug shots til indhold.
  • nFrames normaliseres til de tilladte værdier pr. model.
  • removeWatermark er som standard true for ikke-storyboard-modeller.
  • shots skal inkludere Scene (stort S) og duration > 0.

Eksempler på anmodninger

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

Eksempel på svar

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

Forespørg opgavestatus

Hent status, fremskridt og resultat-URL'er via taskId.

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

Payload-parametre

  • Påkrævet. Det taskId, der returneres ved oprettelse.

Noter

  • Statusværdier: pending | running | succeeded | failed | cancelled.
  • result_url og result_urls returnerer de endelige video-links, når de er klar.

Eksempel på anmodning

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

Eksempel på svar

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

Tjek aktuel kreditsaldo før indsendelse af opgaver.

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

Noter

  • Valgfrit endpoint; nyttigt til preflight-tjek.
  • Returnerer left_credits og is_vip-flag.

Eksempel på anmodning

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

Eksempel på svar

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

Almindelige fejlkoder

Fejl vises gennem code-feltet i svarlegemet.

  • 401: Ikke autoriseret
  • 402: Utilstrækkelige kreditter
  • -1: Ugyldig model-parameter
  • -1: Prompt er påkrævet
  • -1: Billede er påkrævet for image-to-video
  • -1: Shots er påkrævet for storyboard
  • -1: Upload af billede mislykkedes
  • -1: Oprettelse af videogenereringspost mislykkedes

Kreditreference

Kreditter varierer efter model, størrelse og nFrames. Brug denne tabel som udgangspunkt.

ModelParametreKreditter
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. Opret opgaven

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

2. Spor fremskridt

Poll /api/video-generations/check-result indtil status er succeeded eller failed.

3. Verificer kreditter

Kald eventuelt /api/get-user-credits før indsendelse af store batches.

Ofte stillede spørgsmål

Kan jeg bruge API-nøgler eller session-cookies?

Ja. Send Authorization: Bearer [TOKEN] (API-nøgle eller JWT) eller en logget ind session-cookie.

Hvordan formaterer jeg storyboard-shots?

Angiv shots som et array af '{ Scene, duration }', hvor Scene er med stort og duration er sekunder.

Hvorfor varierer kreditter efter model?

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

Nyttige ressourcer

Kom i gang med Sora 2 Pro API'en

Generer en API-nøgle og start dit første Sora 2 Pro-workflow i dag.