Bumuo ng mga video
Ang pagsusumite ay nagbabalik ng HTTP 202 na may ShareAI job ID at polling URL.
Sa pahinang ito
https://api.shareai.now/api/v1/videosBumuo ng mga video
- Base URL
https://api.shareai.now- Pagpapatunay
- Bearer API key o aprubadong OAuth access token
- Kinakailangang scope
inferenceormonetization_gateway
Ang pagsusumite ay nagbabalik ng HTTP 202 na may ShareAI job ID at polling URL. Magpadala ng matatag Idempotency-Key header para sa mga retries ng parehong kahilingan. Ang muling paggamit ng key na iyon na may ibang input ay tinatanggihan. Mag-poll GET /api/v1/videos/{id} gamit ang parehong pinagmulan na kredensyal. Kasama sa mga estado ang queued, pending, in_progress, finalizing, completed, failed at requires_review. Ang resulta ng requires_review ay nangangailangan ng reconciliation ng team; ang polling ay hindi kailanman nagsisimula ng isa pang henerasyon.
Bago ka magsimula#
Itakda ang SHAREAI_API_KEY sa iyong server at palitan ang placeholder ng modelo ng kasalukuyang pinapaganang modelo. Huwag kailanman ilantad ang API key sa browser code. Ang modelo, account, kredensyal, at provider ay dapat lahat pahintulutan ang operasyong ito. Ang mga opsyonal na setting sa ibaba ay nangangailangan ng suporta ng modelo; ang mga hangganan ng kaligtasan ng API ay hindi pangako na ang bawat modelo ay sumusuporta sa bawat halaga.
Magpadala ng kahilingan#
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);Mga field ng kahilingan#
| Patlang | Uri | Kahulugan at mga limitasyon |
|---|---|---|
model kinakailangan | string | Eksaktong pinapaganang pampublikong identifier ng modelo. Dapat ideklara ang operasyong ito at pahintulutan ng iyong kredensyal. |
prompt kinakailangan | string | Hindi walang laman na prompt ng pagbuo, hanggang sa 256 KiB ng UTF-8 na teksto. |
duration | integer | Opsyonal na hiniling na tagal ng video sa segundo, 1–600, higit pang nililimitahan ng napiling modelo. Ang aktwal na ibinalik na mga tagal ang nagtatakda ng billing ng tagal. |
resolution | string | Sinusuportahan ng modelo ang tagapili ng resolusyon, hanggang sa 100 karakter; dapat tumugma sa inilathalang variant ng taripa. |
aspect_ratio | string | Sinusuportahan ng modelo ang tagapili ng aspect ratio, hanggang sa 100 karakter. |
size | string | Sinusuportahan ng modelo ang laki ng output, hanggang sa 100 karakter, halimbawa 1024×1024. Hindi lahat ng modelo ay sumusuporta sa opsyong ito. |
generate_audio | boolean | Opsyonal na tagapili ng soundtrack ng video. Kinakailangan ang suporta ng modelo at ang tumutugmang variant ng taripa. |
seed | integer | Opsyonal na sinusuportahan ng modelo ang seed. Ang video ay nangangailangan ng hindi negatibong integer; ang reproducibility ay nakadepende sa executor. |
frame_images | array | Pinakamataas na dalawang bahagi ng image_url, bawat isa ay may frame_type na first_frame o last_frame, nang walang mga duplicate. Huwag pagsamahin ang frame_images at input_references. |
input_references | array | Hanggang sa 16 na bahagi ng image_url na may image_url.url na nakatakda sa isang HTTPS URL o sinusuportahang URL ng data ng imahe. Kinakailangan ang suporta ng modelo. |
provider | bagay | Opsyonal na mga kagustuhan sa pag-route ng provider. Gamitin ang provider.only para sa mga tinatanggap na tag ng provider, hindi isang prefix sa model ID. Ang mga paghihigpit sa account at kredensyal ay nalalapat pa rin. |
allow_temporary_retention | boolean | Video lamang. Ang tahasang true ay nagpapahintulot sa pansamantalang pag-iimbak ng resulta sa upstream sa mga ruta na nangangailangan nito. Ang hindi pagbanggit/false ay nagpapanatili sa mga rutang iyon na hindi magagamit. Salungat sa provider.zdr:true; ang ibang mga operasyon ay nagpapanatili ng mandatoryong ZDR. |
Basahin ang resulta#
Ang tagumpay ay nagbabalik ng HTTP 202 na may JSON. Ang pagsusumite ay nagbabalik ng HTTP 202 na may ShareAI job ID at polling URL. Magpadala ng matatag Idempotency-Key header para sa mga retries ng parehong kahilingan. Ang muling paggamit ng key na iyon na may ibang input ay tinatanggihan. Mag-poll GET /api/v1/videos/{id} gamit ang parehong pinagmulan na kredensyal. Kasama sa mga estado ang queued, pending, in_progress, finalizing, completed, failed at requires_review. Ang resulta ng requires_review ay nangangailangan ng reconciliation ng team; ang polling ay hindi kailanman nagsisimula ng isa pang henerasyon.
Mga yunit ng pagsingil#
Ang mga ruta ng video ay nagdedeklara ng kanilang mga yunit ng billing. Ang ruta na per-second ay nag-aayos gamit ang sinusukat na tagal ng bawat ibinalik na file, hindi kailanman ang hiniling na tagal o ang upstream USD cost. Ang hiniling na tagal ay dapat nasa pagitan ng 1 at 600 segundo at suportado ng modelo. Ang konserbatibong credit hold ay maaaring sumaklaw sa hanggang apat na output.
Piliin ang eksaktong pinapaganang identifier ng modelo mula sa Console. Ang idineklarang operasyon nito at mga kakayahan sa input/output ay dapat tumugma sa endpoint na ito; ang isang text chat model ay hindi maaaring palitan para sa ibang operasyon. Ang iyong kredensyal, provider, at mga paghihigpit sa account ay nalalapat pa rin.
Pagpepresyo at paggamit#
Ang mga rate ay inilathala sa EUR AI credits para sa napiling modelo, provider, mga yunit, at mga variant. Ang mga sukat lamang sa aktibong taripa nito ang sinisingil. Ang isang pagtatantya ay nagrereserba ng mga kredito bago ang pagpapatupad; ang mga huling singil ay gumagamit ng nasukat na paggamit. Ang mga presyo ay maaaring depende sa resolusyon, format ng output, o isang banda ng paggamit. Suriin ang Console Usage para sa huling ShareAI debit. Ang mga field ng gastos sa upstream at media bytes ay hindi iko-convert sa mga imbentong bilang ng token.
Pag-access at mga error#
Gamitin inference para sa aprubadong inference ng network-cost o monetization_gateway para sa isang aprubadong markup ng Builder at tinatanggap na mga tuntunin sa pagsingil. Ang access na identity-only ay hindi nagbibigay ng awtorisasyon sa paggastos. Ang validation, awtorisasyon ng modelo, hindi sapat na kredito, mga limitasyon sa rate, at mga pagkabigo sa pagpapatupad ay nagbabalik ng structured error. Pagkatapos ng timeout o hindi tiyak na pagsusumite, suriin ang Usage o ang video job bago lumikha ng isa pang posibleng bayad na kahilingan.
Pansamantalang pag-iimbak ng video#
Ang ilang mga ruta ng video ay nangangailangan ng pansamantalang pag-iimbak sa upstream upang ma-retrieve ang nabuong resulta. Kinakailangan nila ang iyong tahasang allow_temporary_retention:true pagtanggap sa kahilingang video na iyon. Ang hindi pagbanggit nito ay nagpapanatili sa mga rutang iyon na hindi magagamit. Ang pagbubukod na ito ay nalalapat lamang sa video at hindi kailanman pinapayagan ang pagsasanay ng modelo o pag-iimbak para sa ibang mga operasyon. Ang tahasang patakaran ng ZDR ay hindi maaaring tahimik na pahinain.
JSON
{"allow_temporary_retention": true}Suriin ang status ng trabaho#
https://api.shareai.now/api/v1/videos/{id}Basahin ang isang henerasyon ng video gamit ang pinagmulan nitong kredensyal
- Base URL
https://api.shareai.now- Pagpapatunay
- Bearer API key o aprubadong OAuth access token
- Kinakailangang scope
inferenceormonetization_gateway
JSON
{
"id": "YOUR_JOB_ID",
"object": "video",
"status": "pending",
"created_at": 1793664000,
"polling_url": "/api/v1/videos/YOUR_JOB_ID"
}Ang JSON sa itaas ay naglalarawan ng matatag na mga field ng trabaho, hindi isang tunay na henerasyon. Mag-poll sa ShareAI path gamit ang parehong key, naghihintay sa pagitan ng mga pagsusuri. Ang queued, pending, in_progress at finalizing ay nangangahulugang maghintay; ang completed ay naglalantad ng data gamit ang ShareAI content URLs; ang failed at requires_review ay nangangahulugang huminto at suriin. Ang status ng retry ay nagbabasa pagkatapos ng mga pansamantalang error, ngunit huwag awtomatikong magsumite muli ng henerasyon. Ang ibang o binawi na kredensyal ay hindi maaaring mag-retrieve ng trabaho.
cURL
curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID" \
-H "Authorization: Bearer $SHAREAI_API_KEY"I-download ang resulta#
Kapag natapos, ang bawat entry ng data ay naglalaman ng ShareAI content URL. Kunin GET /api/v1/videos/{id}/content?index=0 gamit ang parehong pinagmulan na kredensyal. Sinusuportahan ng endpoint ang isang solong HTTP byte range. Ang mga URL ng Provider, mga pribadong tiket at mga kredensyal ng provider ay hindi kailanman ibinabalik. Ang polling at pag-download ay hindi lumilikha ng pangalawang kahilingan sa inference o Monetization Gateway ingestion charge. Ang natapos na trabaho ay nangangahulugang kumpirmado ang settlement bago maging ma-download ang file.
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.mp4Ang opsyonal na frame_images ay dapat maglaman ng mga bahagi ng image_url na may first_frame o last_frame. Gumamit ng frame images o reference images sa isang request, hindi pareho. Ang mga tagal, resolusyon, at aspect ratio ng modelo ay maaaring mas mahigpit kaysa sa mga limitasyon ng kaligtasan ng API. Hindi sinusuportahan ang mga Webhook at arbitrary callback URLs.
Huling na-update Nobyembre 3, 2026