Sora Videos Generation API Integrationsbeskrivning

Denna artikel kommer att introducera integrationsbeskrivningen för Sora Videos Generation API. Genom detta API kan du ange anpassade parametrar för att generera Sora officiella videor. Detta API stöder två versioner:

Version 1 (klassisk mode): Stöder duration (10/15/25 sekunder), orientation (landskap/porträtt), size (small/large upplösning), referensbilder image_urls, karaktärsvideo character_url och andra parametrar.
Version 2 (partnerläge): Stöder seconds (4/8/12 sekunder), pixelupplösning size (t.ex. 1280x720), referensbilder input_reference och andra parametrar.

Ansökningsprocess

För att använda Sora Videos Generation API, börja med att gå till Ace Data Cloud-konsolen för att få din API-token, som du kan spara för framtida bruk.

Om du inte är inloggad eller registrerad kommer du automatiskt att omdirigeras till inloggningssidan för att registrera dig och logga in, och efter att ha slutfört detta kommer du automatiskt att återvända till den aktuella sidan. En API-token räcker för att anropa alla tjänster på plattformen, du behöver inte ansöka separat för varje tjänst. Första ansökan ger en gratis kvot för att prova; när kvoten är slut kan du ladda på allmän balans i konsolen.

📘 Fullständig dokumentation: Sora Videos Generation API →

Grundläggande användning (Version 1)

Först, förstå den grundläggande användningen av Version 1, vilket innebär att du anger en prompt prompt, en array av referensbildlänkar image_urls och en modell model, så får du det bearbetade resultatet. Detaljerna är som följer:

Här kan vi se att vi har ställt in Request Headers, inklusive:

accept: vilken format av svar du vill ta emot, här anges som application/json, vilket innebär JSON-format.
authorization: nyckeln för att anropa API:et, som kan väljas direkt efter ansökan.

Dessutom har vi ställt in Request Body, inklusive:

model: modellen för att generera videon, stöder sora-2 (standardläge) och sora-2-pro (HD-läge). Där sora-2-pro kan stödja videor med duration på 25 sekunder, medan sora-2 endast stöder 10 och 15 sekunder.
size: videons upplösning, small för standardupplösning, large för HD-upplösning (endast Version 1).
duration: videons längd, stöder 10, 15, 25 sekunder, där 25 sekunder endast stöds av sora-2-pro (endast Version 1).
orientation: bildriktning, stöder landscape (landskap), portrait (porträtt) (endast Version 1).
image_urls: array av referensbildlänkar, används för bildgenerering av video (endast Version 1).
character_url: länk till karaktärsvideo, verkliga människor får inte förekomma i videon (endast Version 1).
character_start/character_end: start- och sluttid i sekunder för karaktärens framträdande, med ett intervall på 1-3 sekunder (endast Version 1).
prompt: prompt (obligatorisk).
callback_url: URL för asynkron återkoppling av resultat.
async: valfritt, sätts till true för att omedelbart returnera task_id, utan att behöva ange callback_url, och sedan kan resultatet hämtas genom att fråga motsvarande uppgiftsgränssnitt.
version: API-version, "1.0" (standard) eller "2.0".

När du har valt kan du se att motsvarande kod också genererades till höger, som visas i bilden:

Klicka på “Try” knappen för att testa, som visas i bilden ovan, här fick vi följande resultat:

{
  "success": true,
  "task_id": "6bf7fb83-5814-4e3e-a4ad-bfa0c26c0b33",
  "trace_id": "96166698-4b66-478d-a26b-77a7269c9e01",
  "data": [
    {
      "id": "sora-2:task_01k7770rgsevxsmtpbn7xnm5gh",
      "video_url": "https://platform.cdn.acedata.cloud/gptimage/vg-assets/assets%2Ftask_01k7770rgsevxsmtpbn7xnm5gh%2Ftask_01k7770rgsevxsmtpbn7xnm5gh_genid_0bf958d3-cae7-4298-b7b6-99ae439a1ea6_25_10_10_14_06_975715%2Fvideos%2F00000%2Fsrc.mp4?st=2025-10-10T12%3A30%3A38Z&se=2025-10-16T13%3A30%3A38Z&sks=b&skt=2025-10-10T12%3A30%3A38Z&ske=2025-10-16T13%3A30%3A38Z&sktid=a48cca56-e6da-484e-a814-9c849652bcb3&skoid=8ebb0df1-a278-4e2e-9c20-f2d373479b3a&skv=2019-02-02&sv=2018-11-09&sr=b&sp=r&spr=https%2Chttp&sig=jigY6Z5qp8%2BTXYobaW0EAJ4%2Fbx6G7t6V1P0iyDeUq48%3D&az=oaivgprodscus",
      "state": "succeeded"
    }
  ]
}

Det returnerade resultatet har flera fält, som beskrivs nedan:

success, status för videogenereringsuppgiften.
task_id, ID för videogenereringsuppgiften.
trace_id, spårnings-ID för videogenereringen.
data, resultatlistan för videogenereringsuppgiften.
- id, videons ID för videogenereringsuppgiften.
- video_url, videolänken för videogenereringsuppgiften.
- state, status för videogenereringsuppgiften.

Vi kan se att vi har fått tillfredsställande videoinformation, vi behöver bara hämta den genererade Sora-videon via videolänken i data. Om du vill generera motsvarande integrationskod kan du direkt kopiera den, till exempel CURL-koden nedan:

curl -X POST 'https://api.acedata.cloud/sora/videos' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "size": "large",
  "duration": 15,
  "orientation": "landscape",
  "prompt": "cat running on the river",
  "model": "sora-2"
}'

Bildgenerering av video (Version 1)

Om du vill utföra en bildgenerering av video, måste du först ange referensbildlänkar i parametern image_urls, så kan du specificera följande innehåll:

image_urls: array av referensbildlänkar som används för bildgenerering av video. Observera att du inte får skicka verkliga bilder med ansikten, annars kan det leda till att uppgiften misslyckas.

Exempel på ifyllning:

När du har fyllt i det kommer koden att genereras automatiskt som följer:

Motsvarande kod:

import requests

url = "https://api.acedata.cloud/sora/videos"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "size": "large",
    "duration": 15,
    "orientation": "landscape",
    "prompt": "katt springer på floden",
    "model": "sora-2",
    "image_urls": ["https://cdn.acedata.cloud/11wfp4.png"]
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

Klicka på körning, så kan du se att du omedelbart får ett resultat, som följer:

{
  "success": true,
  "task_id": "dd392ff0-dcb7-4c7a-afd0-9bd4f65c803a",
  "trace_id": "04fd151c-e942-4c1c-a6ab-9a1b1fe54172",
  "data": [
    {
      "id": "sora-2:task_01k777af4hfmg9g7yfvwsc6zws",
      "video_url": "https://platform.cdn.acedata.cloud/gptimage/vg-assets/assets%2Ftask_01k777af4hfmg9g7yfvwsc6zws%2Ftask_01k777af4hfmg9g7yfvwsc6zws_genid_92bae0c5-1703-4a5f-9d9f-c9ed2f9e7176_25_10_10_14_12_924695%2Fvideos%2F00000%2Fsrc.mp4?st=2025-10-10T12%3A37%3A32Z&se=2025-10-16T13%3A37%3A32Z&sks=b&skt=2025-10-10T12%3A37%3A32Z&ske=2025-10-16T13%3A37%3A32Z&sktid=a48cca56-e6da-484e-a814-9c849652bcb3&skoid=aa5ddad1-c91a-4f0a-9aca-e20682cc8969&skv=2019-02-02&sv=2018-11-09&sr=b&sp=r&spr=https%2Chttp&sig=5j4dibeaSsDmEka5c%2B9CKHZhRPdqfClQ0tIh03TWXsM%3D&az=oaivgprodscus",
      "state": "succeeded"
    }
  ]
}

Det kan ses att den genererade effekten är bildgenererad video, resultatet liknar det ovan.

Karaktärsgenerering av videouppgift (Version 1)

Om du vill utföra en karaktärsgenerering av videouppgift, måste parametern character_url först skickas in med videolänken som behövs för att skapa karaktären, observera att videon absolut inte får innehålla verkliga människor, annars kommer det att misslyckas, så kan följande innehåll specificeras:

character_url: Videolänken som behövs för att skapa karaktären, observera att videon absolut inte får innehålla verkliga människor, annars kommer det att misslyckas.

Exempel på ifyllning nedan:

När ifyllningen är klar genereras automatiskt koden nedan:

Motsvarande kod:

import requests

url = "https://api.acedata.cloud/sora/videos"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "size": "small",
    "duration": 10,
    "orientation": "landscape",
    "prompt": "katt springer på floden",
    "character_url": "https://cdn.acedata.cloud/pdidf5.mp4",
    "model": "sora-2",
    "character_end": 3,
    "character_start": 1
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

Klicka på körning, så kan du se att du omedelbart får ett resultat, som följer:

{
  "success": true,
  "task_id": "d9bf5461-29b5-47fd-be90-1fe9197df259",
  "trace_id": "b7992643-9207-40d6-956b-7577728acc67",
  "data": [
    {
      "id": "sora-2:task_01k8ykrztefavaypw6xanw305b",
      "video_url": "https://platform.cdn.acedata.cloud/20251101/bee4eeeb4c4660b46dac4548a1ffbc.mp4",
      "state": "succeeded"
    }
  ]
}

Det kan ses att den genererade effekten är karaktärsgenererad video, resultatet liknar det ovan.

Version 2.0-läge

Förutom ovanstående Version 1.0-läge stöder denna API också Version 2.0-läge, som kan aktiveras genom att ställa in parametern version till "2.0". Version 2.0-läge stöder kortare videolängd och pixelnivåupplösningskontroll.

Version 2.0 Parameterbeskrivning

Parameter	Typ	Obligatorisk	Beskrivning
`version`	string	Ja	Ställ in till `"2.0"`
`prompt`	string	Ja	Prompt för att generera video
`model`	string	Nej	`sora-2` (standard) eller `sora-2-pro`
`duration`	integer	Nej	Videolängd: `4` (standard), `8`, `12` sekunder
`size`	string	Nej	Upplösning: `720x1280` (standard), `1280x720`, `1024x1792`, `1792x1024`
`image_urls`	array	Nej	Array av referensbild-URL:er, endast första bilden används, bildstorleken måste överensstämma med `size`-parametern
`callback_url`	string	Nej	Asynkron callback-URL

Grundläggande exempel

curl -X POST 'https://api.acedata.cloud/sora/videos' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "version": "2.0",
  "prompt": "katt springer på floden",
  "model": "sora-2",
  "duration": 8,
  "size": "1280x720"
}'

Motsvarande Python-kod:

import requests

url = "https://api.acedata.cloud/sora/videos"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "version": "2.0",
    "prompt": "katt springer på floden",
    "model": "sora-2",
    "seconds": 8,
    "size": "1280x720"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

Motsvarande JavaScript-kod:

const response = await fetch('https://api.acedata.cloud/sora/videos', {
  method: 'POST',
  headers: {
    'accept': 'application/json',
    'authorization': 'Bearer {token}',
    'content-type': 'application/json'
  },
  body: JSON.stringify({
    version: '2.0',
    prompt: 'katt springer på floden',
    model: 'sora-2',
    seconds: 8,
    size: '1280x720'
  })
});
const data = await response.json();
console.log(data);

Returresultatet har samma format som Version 1.

{
  "success": true,
  "task_id": "6bf7fb83-5814-4e3e-a4ad-bfa0c26c0b33",
  "trace_id": "96166698-4b66-478d-a26b-77a7269c9e01",
  "data": [
    {
      "id": "c0cc8dad-0954-421f-be8d-02eb063b3263",
      "video_url": "https://platform.cdn.acedata.cloud/sora/xxxxx.mp4",
      "state": "succeeded"
    }
  ]
}

Använda referensbilder (Version 2.0)

I Version 2.0-läget kan referensbilder skickas via image_urls-parametern för att styra videoproduktionen (endast den första bilden används):

import requests

url = "https://api.acedata.cloud/sora/videos"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "version": "2.0",
    "prompt": "en person som går genom en vacker trädgård",
    "model": "sora-2",
    "duration": 4,
    "size": "1280x720",
    "image_urls": ["https://cdn.acedata.cloud/11wfp4.png"]
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

Observera: Storleken på referensbilderna bör överensstämma med size-parametern, till exempel när size är 1280x720, bör storleken på referensbilden vara 1280×720.

Jämförelse av parametrar mellan Version 1.0 och Version 2.0

Parameter	Version 1.0	Version 2.0
`version`	1.0 (standard)	2.0
`prompt`	✅	✅
`model`	✅ sora-2 / sora-2-pro	✅ sora-2 / sora-2-pro
`duration`	✅ 10/15/25 sekunder	✅ 4/8/12 sekunder
`orientation`	✅ liggande/stående	❌
`size`	✅ liten/stor	✅ 720x1280/1280x720/1024x1792/1792x1024
`image_urls`	✅ flera referensbilder	✅ endast den första
`character_url`	✅	❌
`callback_url`	✅	✅

Asynkron callback

Eftersom Sora Videos Generation API:s genereringstid är relativt lång, cirka 1-2 minuter, om API:t inte svarar under en längre tid, kommer HTTP-förfrågan att hålla anslutningen öppen, vilket leder till extra systemresursförbrukning. Därför erbjuder denna API också stöd för asynkron callback. Den övergripande processen är: när klienten initierar en begäran, specificerar den ett extra callback_url-fält. Efter att klienten har initierat API-begäran kommer API:t omedelbart att returnera ett resultat som innehåller ett task_id-fält, vilket representerar det aktuella uppdragets ID. När uppdraget är slutfört kommer resultatet av den genererade videon att skickas till klientens angivna callback_url i POST JSON-format, vilket också inkluderar task_id-fältet, så att uppdragets resultat kan kopplas samman med ID:t. Nedan går vi igenom ett exempel för att förstå hur man gör detta. Först är Webhook-callback en tjänst som kan ta emot HTTP-förfrågningar, utvecklare bör ersätta med URL:en till sin egen byggda HTTP-server. Här för att underlätta demonstration använder vi en offentlig Webhook-exempelsida https://webhook.site/, öppna denna webbplats för att få en Webhook-URL, som visas i bilden:

Kopiera denna URL, så kan den användas som Webhook, exemplet här är https://webhook.site/eb238c4f-da3b-47a5-a922-a93aa5405daa. Därefter kan vi ställa in fältet callback_url till ovanstående Webhook-URL, samtidigt som vi fyller i motsvarande parametrar, innehållet ser ut som bilden visar:

Klicka på kör, så kan vi se att vi omedelbart får ett resultat, som följer:

{
  "task_id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea"
}

Vänta en stund, så kan vi på https://webhook.site/eb238c4f-da3b-47a5-a922-a93aa5405daa observera resultatet av den genererade videon, som visas i bilden:

Innehållet är som följer:

{
  "success": true,
  "task_id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea",
  "trace_id": "fb751e1e-4705-49ea-9fd4-5024b7865ea2",
  "data": [
    {
      "id": "sora-2:task_01k777hjrbfrgs2060q5zvf2a5",
      "video_url": "https://platform.cdn.acedata.cloud/gptimage/vg-assets/assets%2Ftask_01k777hjrbfrgs2060q5zvf2a5%2Ftask_01k777hjrbfrgs2060q5zvf2a5_genid_b8e2e5d1-a579-49ca-a21c-cb3869685cce_25_10_10_14_15_147334%2Fvideos%2F00000%2Fsrc.mp4?st=2025-10-10T12%3A38%3A49Z&se=2025-10-16T13%3A38%3A49Z&sks=b&skt=2025-10-10T12%3A38%3A49Z&ske=2025-10-16T13%3A38%3A49Z&sktid=a48cca56-e6da-484e-a814-9c849652bcb3&skoid=aa5ddad1-c91a-4f0a-9aca-e20682cc8969&skv=2019-02-02&sv=2018-11-09&sr=b&sp=r&spr=https%2Chttp&sig=p4aMqXqkP%2FI1IhOVGCB9JL8vUUvfNBBF12ESpKhKXOk%3D&az=oaivgprodscus",
      "state": "succeeded"
    }
  ]
}

Vi kan se att resultatet innehåller ett task_id-fält, de andra fälten liknar de ovan, och genom detta fält kan uppdraget kopplas samman.

Felhantering

Vid anrop av API:t, om ett fel uppstår, kommer API:t att returnera motsvarande felkod och information. Till exempel:

400 token_mismatched: Felaktig begäran, troligen på grund av saknade eller ogiltiga parametrar.
400 api_not_implemented: Felaktig begäran, troligen på grund av saknade eller ogiltiga parametrar.
401 invalid_token: Obefogad, ogiltig eller saknad auktoriseringstoken.
429 too_many_requests: För många förfrågningar, du har överskridit hastighetsgränsen.
500 api_error: Intern serverfel, något gick fel på servern.

Exempel på felrespons

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "hämtning misslyckades"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Slutsats

Genom detta dokument har du fått en förståelse för hur du använder Sora Videos Generation API för att generera videor genom att ange ledord och referensbilder. Vi hoppas att detta dokument kan hjälpa dig att bättre integrera och använda API:et. Om du har några frågor, tveka inte att kontakta vårt tekniska supportteam.

Getting Started

AI Samtal

AI Bild

AI Video

AI Ljud

Web & Data

CAPTCHA

Identitet

Proxy

Advanced

Coding

Sora Videos Generation API Integrationsbeskrivning

Ansökningsprocess

Grundläggande användning (Version 1)

Bildgenerering av video (Version 1)

Karaktärsgenerering av videouppgift (Version 1)

Version 2.0-läge

Version 2.0 Parameterbeskrivning

Grundläggande exempel

Använda referensbilder (Version 2.0)

Jämförelse av parametrar mellan Version 1.0 och Version 2.0

Asynkron callback

Felhantering

Exempel på felrespons

Slutsats

​Ansökningsprocess

​Grundläggande användning (Version 1)

​Bildgenerering av video (Version 1)

​Karaktärsgenerering av videouppgift (Version 1)

​Version 2.0-läge

​Version 2.0 Parameterbeskrivning

​Grundläggande exempel

​Använda referensbilder (Version 2.0)

​Jämförelse av parametrar mellan Version 1.0 och Version 2.0

​Asynkron callback

​Felhantering

​Exempel på felrespons

​Slutsats

Ansökningsprocess

Grundläggande användning (Version 1)

Bildgenerering av video (Version 1)

Karaktärsgenerering av videouppgift (Version 1)

Version 2.0-läge

Version 2.0 Parameterbeskrivning

Grundläggande exempel

Använda referensbilder (Version 2.0)

Jämförelse av parametrar mellan Version 1.0 och Version 2.0

Asynkron callback

Felhantering

Exempel på felrespons

Slutsats