Tengeneza video
Uwasilishaji unarudisha HTTP 202 na ShareAI job ID na polling URL.
Kwenye ukurasa huu
https://api.shareai.now/api/v1/videosTengeneza video
- URL ya Msingi
https://api.shareai.now- Uthibitishaji
- Funguo ya API ya Bearer au tokeni ya ufikiaji ya OAuth iliyokubaliwa
- Upeo unaohitajika
inferenceormonetization_gateway
Uwasilishaji unarudisha HTTP 202 na ShareAI job ID na polling URL. Tuma Idempotency-Key kichwa thabiti kwa majaribio ya ombi lile lile. Kutumia tena ufunguo huo na pembejeo tofauti hakukubaliki. Fuatilia GET /api/v1/videos/{id} kwa kutumia kitambulisho cha asili. Hali ni pamoja na queued, pending, in_progress, finalizing, completed, failed na requires_review. Matokeo ya requires_review yanahitaji upatanisho wa timu; kufuatilia hakuwahi kuanzisha kizazi kingine.
Kabla ya kuanza#
Weka SHAREAI_API_KEY kwenye seva yako na badilisha nafasi ya mfano na mfano uliowezeshwa kwa sasa. Kamwe usifunue API key kwenye msimbo wa kivinjari. Mfano, akaunti, kitambulisho na mtoa huduma lazima vyote viruhusu operesheni hii. Mipangilio ya hiari hapa chini inahitaji msaada wa mfano; mipaka ya usalama ya API si ahadi kwamba kila mfano unasaidia kila thamani.
Tuma ombi#
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);Sehemu za ombi#
| Sehemu | Aina | Maana na mipaka |
|---|---|---|
model inahitajika | kamba | Kitambulisho halisi cha mfano wa umma uliowezeshwa. Lazima kitangaze operesheni hii na kuruhusiwa na kitambulisho chako. |
prompt inahitajika | kamba | Maelezo ya kizazi yasiyo tupu, si zaidi ya 256 KiB ya maandishi ya UTF-8. |
duration | nambari kamili | Muda wa video uliombwa kwa hiari kwa sekunde, 1–600, unaozuiliwa zaidi na mfano ulioteuliwa. Muda halisi uliorudishwa huamua malipo ya muda. |
resolution | kamba | Kichagua azimio kinachoungwa mkono na mfano, si zaidi ya herufi 100; lazima kilingane na toleo la ada lililochapishwa. |
aspect_ratio | kamba | Kichagua uwiano wa kipengele kinachoungwa mkono na mfano, si zaidi ya herufi 100. |
size | kamba | Ukubwa wa pato unaoungwa mkono na mfano, si zaidi ya herufi 100, kwa mfano 1024×1024. Sio kila mfano unaounga mkono chaguo hili. |
generate_audio | boolean | Kichagua wimbo wa sauti wa video kwa hiari. Msaada wa mfano na toleo la ada linalolingana vinahitajika. |
seed | nambari kamili | Mbegu inayoungwa mkono na mfano kwa hiari. Video inahitaji nambari isiyo hasi; urudufishaji unategemea mtekelezaji. |
frame_images | safu | Sehemu mbili za image_url kwa zaidi, kila moja ikiwa na frame_type first_frame au last_frame, bila nakala. Usichanganye frame_images na input_references. |
input_references | safu | Sehemu 16 za image_url zilizoainishwa kwa zaidi na image_url.url iliyowekwa kwa URL ya HTTPS au URL ya data ya picha inayoungwa mkono. Msaada wa mfano unahitajika. |
provider | kitu | Mapendeleo ya hiari ya uelekezaji wa mtoa huduma. Tumia provider.only kwa vitambulisho vya mtoa huduma vilivyokubaliwa, si kiambishi awali kwenye ID ya mfano. Vizuizi vya akaunti na kitambulisho bado vinatumika. |
allow_temporary_retention | boolean | Video pekee. Thibitisho la kweli linaruhusu uhifadhi wa muda wa matokeo ya juu kwenye njia zinazohitaji. Kukosekana/uwongo kunafanya njia hizo zisipatikane. Inapingana na provider.zdr:true; shughuli zingine zinahifadhi ZDR ya lazima. |
Soma matokeo#
Mafanikio yanarudisha HTTP 202 na JSON. Uwasilishaji unarudisha HTTP 202 na ShareAI job ID na polling URL. Tuma Idempotency-Key kichwa thabiti kwa majaribio ya ombi lile lile. Kutumia tena ufunguo huo na pembejeo tofauti hakukubaliki. Fuatilia GET /api/v1/videos/{id} kwa kutumia kitambulisho cha asili. Hali ni pamoja na queued, pending, in_progress, finalizing, completed, failed na requires_review. Matokeo ya requires_review yanahitaji upatanisho wa timu; kufuatilia hakuwahi kuanzisha kizazi kingine.
Vitengo vya malipo#
Njia za video zinatangaza vitengo vyao vilivyolipiwa. Njia ya kila sekunde inakamilisha kwa kutumia muda uliopimwa wa kila faili iliyorejeshwa, kamwe si muda uliombwa au gharama ya USD ya juu. Muda uliombwa lazima uwe kati ya sekunde 1 na 600 na uungwe mkono na mfano. Hifadhi ya mkopo ya kihafidhina inaweza kufidia hadi matokeo manne.
Chagua kitambulisho halisi cha mfano uliowezeshwa kutoka Console. Operesheni yake iliyotangazwa na uwezo wa pembejeo/pato lazima vilingane na endpoint hii; mfano wa mazungumzo ya maandishi hauwezi kubadilishwa kwa operesheni nyingine. Vizuizi vya kitambulisho, mtoa huduma na akaunti yako bado vinatumika.
Bei na matumizi#
Viwango vinachapishwa kwa EUR AI credits kwa mfano ulioteuliwa, mtoa huduma, vitengo na tofauti. Vipimo tu katika ada yake inayotumika vinatozwa. Makadirio yanahifadhi credits kabla ya utekelezaji; malipo ya mwisho hutumia matumizi yaliyopimwa. Bei zinaweza kutegemea azimio, muundo wa pato au kiwango cha matumizi. Angalia Console Usage kwa deni la mwisho la ShareAI. Sehemu za gharama za juu na baiti za vyombo vya habari hazibadilishwi kuwa hesabu za tokeni zilizobuniwa.
Ufikiaji na makosa#
Tumia inference kwa inference ya gharama ya mtandao iliyokubaliwa au monetization_gateway kwa markup ya Builder iliyokubaliwa na masharti ya malipo yaliyokubaliwa. Ufikiaji wa kitambulisho pekee hauidhinishi matumizi. Uthibitishaji, idhini ya mfano, credits zisizotosha, mipaka ya kiwango na kushindwa kwa utekelezaji hurudisha error. Baada ya muda wa kusubiri au uwasilishaji usio na uhakika, kagua Usage au kazi ya video kabla ya kuunda ombi lingine linaloweza kulipwa.
Uhifadhi wa muda wa video#
Njia zingine za video zinahitaji uhifadhi wa muda wa juu ili matokeo yaliyotengenezwa yaweze kupatikana. Zinahitaji allow_temporary_retention:true kukubalika kwako wazi kwenye ombi hilo la video. Kukosekana kwake kunafanya njia hizo zisipatikane. Utoaji huu unatumika kwa video pekee na hauwaruhusu mafunzo ya mfano au uhifadhi kwa shughuli zingine. Sera ya ZDR ya wazi haiwezi kudhoofishwa kimya kimya.
JSON
{"allow_temporary_retention": true}Angalia hali ya kazi#
https://api.shareai.now/api/v1/videos/{id}Soma kizazi cha video kwa kutumia kitambulisho chake cha asili
- URL ya Msingi
https://api.shareai.now- Uthibitishaji
- Funguo ya API ya Bearer au tokeni ya ufikiaji ya OAuth iliyokubaliwa
- Upeo unaohitajika
inferenceormonetization_gateway
JSON
{
"id": "YOUR_JOB_ID",
"object": "video",
"status": "pending",
"created_at": 1793664000,
"polling_url": "/api/v1/videos/YOUR_JOB_ID"
}JSON hapo juu inaonyesha sehemu thabiti za kazi, si kizazi halisi. Fuatilia njia ya ShareAI kwa kutumia ufunguo ule ule, ukisubiri kati ya ukaguzi. queued, pending, in_progress na finalizing inamaanisha subiri; completed inaonyesha data na ShareAI content URLs; failed na requires_review inamaanisha simama na kagua. Hali ya majaribio husomwa baada ya makosa ya muda mfupi, lakini usitumie tena kizazi kiotomatiki. Kitambulisho tofauti au kilichobatilishwa hakiwezi kurejesha kazi.
cURL
curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID" \
-H "Authorization: Bearer $SHAREAI_API_KEY"Pakua matokeo#
Wakati kazi imekamilika, kila ingizo la data lina URL ya maudhui ya ShareAI. Pakua GET /api/v1/videos/{id}/content?index=0 ukitumia kitambulisho cha asili sawa. Endpoint inasaidia safu moja ya baiti ya HTTP. URL za Provider, tiketi za kibinafsi na vitambulisho vya Provider havirudishwi kamwe. Kupiga kura na kupakua hakutengenezi ombi la pili la inference au malipo ya Monetization Gateway. Kazi iliyokamilika inamaanisha malipo yamethibitishwa kabla ya faili kupakuliwa.
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 za hiari lazima ziwe na sehemu za image_url zenye first_frame au last_frame. Tumia picha za fremu au picha za marejeleo katika ombi moja, si zote mbili. Muda wa modeli, maazimio na uwiano wa vipimo vinaweza kuwa na vizuizi zaidi kuliko mipaka ya usalama ya API. Webhooks na URL za callback za kiholela haziruhusiwi.
Ilisasishwa mwisho Novemba 3, 2026