ShareAI Platform Docs

Tengeneza video

Uwasilishaji unarudisha HTTP 202 na ShareAI job ID na polling URL.

Tazama kama Markdown
Kwenye ukurasa huu
POST https://api.shareai.now/api/v1/videos

Tengeneza video

URL ya Msingi
https://api.shareai.now
Uthibitishaji
Funguo ya API ya Bearer au tokeni ya ufikiaji ya OAuth iliyokubaliwa
Upeo unaohitajika
inference or monetization_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
}'

Sehemu za ombi#

SehemuAinaMaana na mipaka
model inahitajikakambaKitambulisho halisi cha mfano wa umma uliowezeshwa. Lazima kitangaze operesheni hii na kuruhusiwa na kitambulisho chako.
prompt inahitajikakambaMaelezo ya kizazi yasiyo tupu, si zaidi ya 256 KiB ya maandishi ya UTF-8.
durationnambari kamiliMuda wa video uliombwa kwa hiari kwa sekunde, 1–600, unaozuiliwa zaidi na mfano ulioteuliwa. Muda halisi uliorudishwa huamua malipo ya muda.
resolutionkambaKichagua azimio kinachoungwa mkono na mfano, si zaidi ya herufi 100; lazima kilingane na toleo la ada lililochapishwa.
aspect_ratiokambaKichagua uwiano wa kipengele kinachoungwa mkono na mfano, si zaidi ya herufi 100.
sizekambaUkubwa wa pato unaoungwa mkono na mfano, si zaidi ya herufi 100, kwa mfano 1024×1024. Sio kila mfano unaounga mkono chaguo hili.
generate_audiobooleanKichagua wimbo wa sauti wa video kwa hiari. Msaada wa mfano na toleo la ada linalolingana vinahitajika.
seednambari kamiliMbegu inayoungwa mkono na mfano kwa hiari. Video inahitaji nambari isiyo hasi; urudufishaji unategemea mtekelezaji.
frame_imagessafuSehemu 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_referencessafuSehemu 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.
providerkituMapendeleo 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_retentionbooleanVideo 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#

GET 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
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 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.mp4

frame_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

Nyaraka za Jukwaa la ShareAI
Nyaraka zote

Tafuta kwa kichwa au maudhui.

Uliza kuhusu ukurasa huu

Chagua msaidizi wa kuchunguza ukurasa huu. Unaweza pia kunakili ukurasa na kuubandika kwenye mazungumzo yako.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI