Generează videoclipuri
Trimiterea returnează HTTP 202 cu un ShareAI job ID și un URL de interogare.
Pe această pagină
https://api.shareai.now/api/v1/videosGenerează videoclipuri
- URL de bază
https://api.shareai.now- Autentificare
- Cheie API Bearer sau token de acces OAuth aprobat
- Scop necesar
inferenceormonetization_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
}'Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_VIDEOS_MODEL',
'prompt': 'A slow camera move through a quiet forest.',
'duration': 8}
headers = {'Content-Type': 'application/json', 'Idempotency-Key': 'YOUR_UNIQUE_REQUEST_ID'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/videos', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
result = json.load(response)
print(result)TypeScript
const response = await fetch("https://api.shareai.now/api/v1/videos", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json", "Idempotency-Key": "YOUR_UNIQUE_REQUEST_ID"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_VIDEOS_MODEL",
"prompt": "A slow camera move through a quiet forest.",
"duration": 8
}),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);Câmpuri cerere#
| Câmp | Tip | Semnificație și limite |
|---|---|---|
model necesar | șir | Identificatorul exact al modelului public activat. Trebuie să declare această operațiune și să fie permis de acreditivul tău. |
prompt necesar | șir | Prompt de generare non-gol, cel mult 256 KiB de text UTF-8. |
duration | întreg | Durata videoclipului solicitată opțional, în secunde, 1–600, restricționată suplimentar de modelul selectat. Duratele efectiv returnate determină facturarea duratei. |
resolution | șir | Selector de rezoluție suportată de model, cel mult 100 de caractere; trebuie să corespundă variantei tarifare publicate. |
aspect_ratio | șir | Selector de raport de aspect suportat de model, cel mult 100 de caractere. |
size | șir | Dimensiunea de ieșire suportată de model, cel mult 100 de caractere, de exemplu 1024×1024. Nu fiecare model suportă această opțiune. |
generate_audio | boolean | Selector opțional pentru coloana sonoră a videoclipului. Suportul modelului și varianta tarifară corespunzătoare sunt necesare. |
seed | întreg | Sămânță suportată opțional de model. Videoclipul necesită un număr întreg nenegativ; reproducibilitatea depinde de executor. |
frame_images | array | Cel 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_references | array | Cel 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. |
provider | obiect | Preferinț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_retention | boolean | Doar 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#
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
inferenceormonetization_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.mp4Frame_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