ShareAI Platform Docs

Generează videoclipuri

Trimiterea returnează HTTP 202 cu un ShareAI job ID și un URL de interogare.

Vizualizează ca Markdown
Pe această pagină
POST https://api.shareai.now/api/v1/videos

Generează videoclipuri

URL de bază
https://api.shareai.now
Autentificare
Cheie API Bearer sau token de acces OAuth aprobat
Scop necesar
inference or monetization_gateway

Trimiterea returnează HTTP 202 cu un ShareAI job ID și un URL de interogare. Trimite un Idempotency-Key antet stabil pentru reluarea aceleiași cereri. Reutilizarea acelei chei cu intrări diferite este respinsă. Interoghează GET /api/v1/videos/{id} cu aceeași acreditare de origine. Stările includ în coadă, în așteptare, în desfășurare, finalizare, completat, eșuat și necesită revizuire. Un rezultat care necesită revizuire are nevoie de reconcilierea echipei; interogarea nu începe niciodată o altă generare.

Înainte de a începe#

Setează SHAREAI_API_KEY pe serverul tău și înlocuiește placeholder-ul modelului cu un model activat în prezent. Nu expune niciodată cheia API în codul browserului. Modelul, contul, acreditivul și providerul trebuie să permită această operațiune. Setările opționale de mai jos necesită suportul modelului; limitele de siguranță ale API-ului nu garantează că fiecare model suportă fiecare valoare.

Trimite o cerere#

cURL

curl --fail-with-body --request POST "https://api.shareai.now/api/v1/videos" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
  --data '{
  "model": "YOUR_ENABLED_VIDEOS_MODEL",
  "prompt": "A slow camera move through a quiet forest.",
  "duration": 8
}'

Câmpuri cerere#

CâmpTipSemnificație și limite
model necesarșirIdentificatorul exact al modelului public activat. Trebuie să declare această operațiune și să fie permis de acreditivul tău.
prompt necesarșirPrompt de generare non-gol, cel mult 256 KiB de text UTF-8.
durationîntregDurata videoclipului solicitată opțional, în secunde, 1–600, restricționată suplimentar de modelul selectat. Duratele efectiv returnate determină facturarea duratei.
resolutionșirSelector de rezoluție suportată de model, cel mult 100 de caractere; trebuie să corespundă variantei tarifare publicate.
aspect_ratioșirSelector de raport de aspect suportat de model, cel mult 100 de caractere.
sizeșirDimensiunea de ieșire suportată de model, cel mult 100 de caractere, de exemplu 1024×1024. Nu fiecare model suportă această opțiune.
generate_audiobooleanSelector opțional pentru coloana sonoră a videoclipului. Suportul modelului și varianta tarifară corespunzătoare sunt necesare.
seedîntregSămânță suportată opțional de model. Videoclipul necesită un număr întreg nenegativ; reproducibilitatea depinde de executor.
frame_imagesarrayCel mult două părți image_url, fiecare cu frame_type first_frame sau last_frame, fără duplicate. Nu combina frame_images și input_references.
input_referencesarrayCel mult 16 părți image_url tipizate cu image_url.url setat la un URL HTTPS sau un URL de date imagine suportat. Suportul modelului este necesar.
providerobiectPreferințe opționale de rutare ale providerului. Utilizează provider.only pentru tag-uri de provider acceptate, nu un prefix în ID-ul modelului. Restricțiile contului și acreditivului se aplică în continuare.
allow_temporary_retentionbooleanDoar videoclip. Explicit true permite retenția temporară a rezultatului în amonte pe rutele care o necesită. Omis/fals menține acele rute indisponibile. Conflicte cu provider.zdr:true; alte operațiuni păstrează ZDR obligatoriu.

Citește rezultatul#

Succesul returnează HTTP 202 cu JSON. Trimiterea returnează HTTP 202 cu un ShareAI job ID și un URL de interogare. Trimite un Idempotency-Key antet stabil pentru reluarea aceleiași cereri. Reutilizarea acelei chei cu intrări diferite este respinsă. Interoghează GET /api/v1/videos/{id} cu aceeași acreditare de origine. Stările includ în coadă, în așteptare, în desfășurare, finalizare, completat, eșuat și necesită revizuire. Un rezultat care necesită revizuire are nevoie de reconcilierea echipei; interogarea nu începe niciodată o altă generare.

Unități de facturare#

Rutele video declară unitățile facturate. O rută pe secundă se stabilește folosind durata măsurată a fiecărui fișier returnat, niciodată durata solicitată sau un cost USD în amonte. Durata solicitată trebuie să fie între 1 și 600 de secunde și suportată de model. O rezervă conservatoare de credit poate acoperi până la patru ieșiri.

Alege identificatorul exact al modelului activat din Console. Operațiunea declarată și capacitățile de intrare/ieșire trebuie să se potrivească cu acest endpoint; un model de chat text nu poate fi substituit pentru o altă operațiune. Restricțiile acreditivului, providerului și contului tău se aplică în continuare.

Prețuri și utilizare#

Tarifele sunt publicate în credite AI EUR pentru modelul, providerul, unitățile și variantele selectate. Sunt taxate doar dimensiunile din tariful său activ. O estimare rezervă credite înainte de execuție; taxele finale utilizează utilizarea măsurată. Prețurile pot depinde de rezoluție, formatul de ieșire sau un interval de utilizare. Verifică Console Usage pentru debitul final ShareAI. Câmpurile de cost upstream și byte-urile media nu sunt convertite în număr de token inventat.

Acces și erori#

Utilizează inference pentru inferență aprobată cu costuri de rețea sau monetization_gateway pentru un adaos aprobat de Builder și termeni de facturare acceptați. Accesul doar pe bază de identitate nu autorizează cheltuieli. Validarea, autorizarea modelului, creditele insuficiente, limitele de rată și eșecurile de execuție returnează un error. După un timeout sau o trimitere incertă, inspectează Usage sau job-ul video înainte de a crea o altă cerere potențial plătită.

Retenție temporară a videoclipului#

Unele rute video necesită retenție temporară în amonte pentru ca rezultatul generat să poată fi recuperat. Ele necesită acceptarea ta explicită allow_temporary_retention:true pentru acea cerere video. Omiterea menține acele rute indisponibile. Această excepție se aplică doar videoclipurilor și nu permite niciodată antrenarea modelului sau retenția pentru alte operațiuni. O politică ZDR explicită nu poate fi slăbită în mod tacit.

JSON

{"allow_temporary_retention": true}

Verifică starea jobului#

GET https://api.shareai.now/api/v1/videos/{id}

Citește o generare video cu acreditarea sa de origine

URL de bază
https://api.shareai.now
Autentificare
Cheie API Bearer sau token de acces OAuth aprobat
Scop necesar
inference or monetization_gateway

JSON

{
  "id": "YOUR_JOB_ID",
  "object": "video",
  "status": "pending",
  "created_at": 1793664000,
  "polling_url": "/api/v1/videos/YOUR_JOB_ID"
}

JSON-ul de mai sus ilustrează câmpurile stabile ale jobului, nu o generare reală. Interoghează calea ShareAI cu aceeași cheie, așteptând între verificări. în coadă, în așteptare, în desfășurare și finalizare înseamnă așteptare; completat expune datele cu URL-uri de conținut ShareAI; eșuat și necesită revizuire înseamnă oprire și inspecție. Starea de reluare se citește după erori tranzitorii, dar nu resubmite automat generarea. O acreditare diferită sau revocată nu poate recupera jobul.

cURL

curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID" \
  -H "Authorization: Bearer $SHAREAI_API_KEY"

Descarcă rezultatul#

Când este finalizat, fiecare intrare de date conține un URL de conținut ShareAI. Preia GET /api/v1/videos/{id}/content?index=0 folosind aceeași acreditare de origine. Endpoint-ul acceptă un singur interval de octeți HTTP. URL-urile Provider, biletele private și acreditările Provider nu sunt niciodată returnate. Interogarea și descărcarea nu creează o a doua cerere de inferență sau o taxă de ingestie Monetization Gateway. Un job finalizat înseamnă că decontarea este confirmată înainte ca fișierul să devină descărcabil.

cURL

curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID/content?index=0" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" --output result.mp4

Frame_images opționale trebuie să conțină părți image_url cu first_frame sau last_frame. Folosește imagini de cadre sau imagini de referință într-o singură cerere, nu ambele. Duratele modelelor, rezoluțiile și rapoartele de aspect pot fi mai restrictive decât limitele de siguranță ale API-ului. Webhook-urile și URL-urile de callback arbitrare nu sunt acceptate.

Ultima actualizare noiembrie 3, 2026

Documentația platformei ShareAI
Toată documentația

Caută după titlu sau conținut.

Întreabă despre această pagină

Alege un asistent pentru a explora această pagină. Poți, de asemenea, să copiezi pagina și să o inserezi în conversația ta.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI