Ƙirƙiri bidiyo
Bayarwa tana dawowa da HTTP 202 tare da ShareAI job ID da polling URL.
A wannan shafin
https://api.shareai.now/api/v1/videosƘirƙiri bidiyo
- URL na Asali
https://api.shareai.now- Tantancewa
- Maɓallin API na Bearer ko takardar izinin shiga OAuth da aka amince da ita
- Dole ne a sami izini
inferenceormonetization_gateway
Bayarwa tana dawowa da HTTP 202 tare da ShareAI job ID da URL na bincike. Aika da kwatankwacin Idempotency-Key header don maimaita buƙatun iri ɗaya. Amfani da maɓalli ɗaya tare da shigarwa daban yana ƙin karɓuwa. Yi bincike GET /api/v1/videos/{id} tare da takaddun shaida na asali iri ɗaya. Yanayi sun haɗa da queued, pending, in_progress, finalizing, completed, failed da requires_review. Sakamakon requires_review yana buƙatar daidaitawar ƙungiya; bincike ba zai fara wani ƙarni ba.
Kafin ka fara#
Saita SHAREAI_API_KEY akan uwar garken ku kuma maye gurbin wurin samfurin samfurin da samfurin da aka kunna a halin yanzu. Kada ku taɓa bayyana maɓallin API a cikin lambar burauza. Samfurin, asusu, takaddun shaida da mai bayarwa dole ne duk su ba da izinin wannan aikin. Saitunan zaɓi a ƙasa suna buƙatar tallafin samfurin; iyakokin aminci na API ba alkawari bane cewa kowane samfurin yana tallafawa kowane ƙima.
Aika buƙata#
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);Filayen buƙata#
| Filin | Nau'in | Ma'ana da iyakoki |
|---|---|---|
model wajibi | kirtani | Takamaiman mai gano samfurin jama'a da aka kunna. Dole ne a bayyana wannan aiki kuma takardun shaidarka su yarda da shi. |
prompt wajibi | kirtani | Tambayar ƙarni mara komai, mafi girma 256 KiB na rubutun UTF-8. |
duration | lamba | Zaɓin tsawon bidiyo da aka nema a cikin daƙiƙoƙi, 1–600, wanda aka ƙara takaita ta samfurin da aka zaɓa. Tsawon da aka dawo da shi na ainihi yana ƙayyade cajin tsawon lokaci. |
resolution | kirtani | Zaɓin ƙudurin da samfurin ke tallafawa, mafi girma haruffa 100; dole ne ya dace da bambancin farashin da aka buga. |
aspect_ratio | kirtani | Zaɓin rabo na bangare da samfurin ke tallafawa, mafi girma haruffa 100. |
size | kirtani | Girman fitarwa da samfurin ke tallafawa, mafi girma haruffa 100, misali 1024×1024. Ba duk samfurori ke tallafawa wannan zaɓi ba. |
generate_audio | gaskiya/ƙarya | Zaɓin waƙar bidiyo na zaɓi. Ana buƙatar tallafin samfurin da bambancin farashin da ya dace. |
seed | lamba | Zaɓin iri na samfurin da ake tallafawa. Bidiyo yana buƙatar lamba mai kyau; maimaituwa tana dogara da mai aiwatarwa. |
frame_images | jerin abubuwa | Mafi yawan sassa biyu na image_url, kowanne tare da frame_type na farko ko na ƙarshe, ba tare da maimaitawa ba. Kada a haɗa frame_images da input_references. |
input_references | jerin abubuwa | Mafi yawan sassa 16 na image_url da aka rubuta tare da image_url.url da aka saita zuwa URL na HTTPS ko URL na bayanan hoto da aka tallafawa. Ana buƙatar tallafin samfurin. |
provider | abu | Zaɓin fifikon hanyar mai bayarwa. Yi amfani da provider.only don alamun mai bayarwa da aka karɓa, ba don farkon ID na samfur ba. Har yanzu ana amfani da iyakokin asusu da takardun shaida. |
allow_temporary_retention | gaskiya/ƙarya | Bidiyo kawai. Gaskiya mai bayyana tana ba da izinin riƙe sakamakon ɗan lokaci a hanyoyin da ke buƙatar hakan. Rashin bayyana/gaskiya yana sa waɗannan hanyoyin su kasance marasa samuwa. Ya saba da provider.zdr:true; sauran ayyuka suna riƙe da ZDR na dole. |
Karanta sakamakon#
Nasara tana dawowa da HTTP 202 tare da JSON. Bayarwa tana dawowa da HTTP 202 tare da ShareAI job ID da URL na bincike. Aika da kwatankwacin Idempotency-Key header don maimaita buƙatun iri ɗaya. Amfani da maɓalli ɗaya tare da shigarwa daban yana ƙin karɓuwa. Yi bincike GET /api/v1/videos/{id} tare da takaddun shaida na asali iri ɗaya. Yanayi sun haɗa da queued, pending, in_progress, finalizing, completed, failed da requires_review. Sakamakon requires_review yana buƙatar daidaitawar ƙungiya; bincike ba zai fara wani ƙarni ba.
Rukunin biyan kuɗi#
Hanyoyin bidiyo suna bayyana raka'o'in da ake cajin su. Hanya ta kowane daƙiƙa tana biyan kuɗi ta amfani da tsawon lokacin da aka auna na kowane fayil da aka dawo da shi, ba tsawon lokacin da aka nema ba ko farashin USD na sama. Dole ne tsawon lokacin da aka nema ya kasance tsakanin daƙiƙa 1 zuwa 600 kuma samfurin ya tallafa masa. Ana iya rike kuɗin bashi mai tsauri har zuwa fitarwa huɗu.
Zaɓi ainihin mai gano samfurin da aka kunna daga Console. Ayyukansa da damar shigarwa/fitarwa da aka bayyana dole ne su dace da wannan wurin; samfurin hira da rubutu ba za a iya maye gurbinsa da wani aiki ba. Takaddun shaida, mai bayarwa da iyakokin asusunku har yanzu suna aiki.
Farashi da amfani#
Farashin ana wallafa su a cikin EUR AI credits don samfurin da aka zaɓa, mai bayarwa, raka'o'i da bambance-bambance. Ana cajin kawai girman da ke cikin farashin aiki. Kimantawa yana adana credits kafin aiwatarwa; cajin ƙarshe yana amfani da amfani da aka auna. Farashin na iya dogara da ƙuduri, tsarin fitarwa ko rukuni na amfani. Duba Console Usage don ShareAI debit na ƙarshe. Filayen farashin sama da bytes na kafofin watsa labarai ba a canza su zuwa adadin tokon da aka ƙirƙira ba.
Samuwa da kurakurai#
Amfani inference don amincewa da farashin hanyar sadarwa ko monetization_gateway don amincewa da ƙarin Builder da sharuɗɗan biyan kuɗi da aka karɓa. Samun izini kawai ba ya ba da izinin kashe kuɗi. Tabbatarwa, izinin samfurin, ƙarancin credits, iyakokin farashi da gazawar aiwatarwa suna dawo da tsari error. Bayan lokaci ko gabatarwa mara tabbas, bincika Amfani ko aikin bidiyo kafin ƙirƙirar wata buƙata mai yiwuwa da aka biya.
Riƙe bidiyo na ɗan lokaci#
Wasu hanyoyin bidiyo suna buƙatar riƙe sakamakon ɗan lokaci na sama don a iya dawo da sakamakon da aka samar. Suna buƙatar allow_temporary_retention:true amincewarka a kan wannan buƙatar bidiyo. Rashin bayyana shi yana sa waɗannan hanyoyin su kasance marasa samuwa. Wannan keɓancewa tana aiki ne kawai ga bidiyo kuma ba ta taɓa ba da izinin horar da samfurin ko riƙewa don wasu ayyuka ba. Ba za a iya rage manufofin ZDR da aka bayyana ba a hankali.
JSON
{"allow_temporary_retention": true}Duba matsayin aiki#
https://api.shareai.now/api/v1/videos/{id}Karanta ƙarni na bidiyo tare da takaddun shaida na asali
- URL na Asali
https://api.shareai.now- Tantancewa
- Maɓallin API na Bearer ko takardar izinin shiga OAuth da aka amince da ita
- Dole ne a sami izini
inferenceormonetization_gateway
JSON
{
"id": "YOUR_JOB_ID",
"object": "video",
"status": "pending",
"created_at": 1793664000,
"polling_url": "/api/v1/videos/YOUR_JOB_ID"
}JSON da ke sama yana nuna filayen aikin da ke da kwanciyar hankali, ba ƙarni na gaske ba. Yi bincike a kan hanyar ShareAI tare da maɓalli iri ɗaya, kana jiran tsakanin dubawa. queued, pending, in_progress da finalizing suna nufin jira; completed yana bayyana bayanai tare da URLs na abun ciki na ShareAI; failed da requires_review suna nufin dakatawa da bincike. Sake gwada karanta matsayin bayan kurakurai na wucin gadi, amma kada a sake bayar da ƙarni ta atomatik. Takaddun shaida daban ko waɗanda aka soke ba za su iya dawo da aikin ba.
cURL
curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID" \
-H "Authorization: Bearer $SHAREAI_API_KEY"Sauke sakamakon#
Idan an kammala, kowane shigar bayanai yana ƙunshe da URL na abun ciki na ShareAI. Samu GET /api/v1/videos/{id}/content?index=0 ta yin amfani da asalin takardar shedar. Ƙarshen yana goyan bayan kewayon HTTP byte guda ɗaya. Ba a dawo da URLs na Provider, tikiti masu zaman kansu da takardun shedar mai bayarwa ba. Yin amfani da polling da saukarwa ba ya ƙirƙirar buƙatar fahimtar AI ta biyu ko cajin shigar Monetization Gateway. Aikin da aka kammala yana nufin an tabbatar da biyan kuɗi kafin fayil ɗin ya zama mai saukarwa.
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.mp4Dole ne zaɓin frame_images ya ƙunshi sassa na image_url tare da first_frame ko last_frame. Yi amfani da hotunan frame ko hotunan tunani a cikin buƙata ɗaya, ba duka ba. Tsawon lokaci na samfurori, ƙuduri da rabo na bangarori na iya zama mafi tsauri fiye da iyakokin aminci na API. Ba a goyan bayan webhooks da URLs na kira na musamman ba.
An sabunta karshe Nuwamba 3, 2026