ShareAI Platform Docs

Nggawe video

Kiriman bali HTTP 202 karo ID tugas ShareAI lan URL polling.

Deleng minangka Markdown
Ing kaca iki
POST https://api.shareai.now/api/v1/videos

Nggawe video

URL Dasar
https://api.shareai.now
Otentikasi
Bearer API key utawa token akses OAuth sing disetujui
Lingkup sing dibutuhake
inference or monetization_gateway

Kiriman bali HTTP 202 karo ShareAI ID tugas lan polling URL. Kirim header Idempotency-Key stabil kanggo nyoba ulang panjalukan sing padha. Nggunakake kunci kuwi karo input beda ditolak. Polling GET /api/v1/videos/{id} nganggo kredensial asal sing padha. Status kalebu queued, pending, in_progress, finalizing, completed, failed lan requires_review. Asil requires_review butuh rekonsiliasi tim; polling ora tau miwiti generasi anyar.

Sadurunge sampeyan miwiti#

Set SHAREAI_API_KEY ing server sampeyan lan ganti placeholder model karo model sing saiki diaktifake. Aja tau mbukak API key ing kode browser. Model, akun, kredensial lan panyedhiya kudu kabeh ngidini operasi iki. Setelan opsional ing ngisor iki mbutuhake dhukungan model; watesan safety API ora janji yen saben model ndhukung saben nilai.

Kirim panjalukan#

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
}'

Lapangan panjalukan#

LapanganTipeMakna lan watesan
model dibutuhakestringIdentifikasi model publik sing diaktifake kanthi tepat. Kudu nyatakake operasi iki lan diidini dening kredensial sampeyan.
prompt dibutuhakestringPrompt generasi ora kosong, maksimal 256 KiB teks UTF-8.
durationintegerDurasi video sing dijaluk opsional ing detik, 1–600, luwih diwatesi dening model sing dipilih. Durasi sing bali nyata nemtokake tagihan durasi.
resolutionstringSelector resolusi sing didhukung model, maksimal 100 karakter; kudu cocog karo varian tarif sing diterbitake.
aspect_ratiostringSelector rasio aspek sing didhukung model, maksimal 100 karakter.
sizestringUkuran asil sing didhukung model, maksimal 100 karakter, contone 1024×1024. Ora saben model ndhukung pilihan iki.
generate_audiobooleanSelector soundtrack video opsional. Dhukungan model lan varian tarif sing cocog dibutuhake.
seedintegerBibit sing didhukung model opsional. Video mbutuhake integer non-negatif; reproducibility gumantung marang eksekutor.
frame_imagesarrayMaksimal loro bagian image_url, saben nganggo frame_type first_frame utawa last_frame, tanpa duplikat. Aja nggabungake frame_images lan input_references.
input_referencesarrayMaksimal 16 bagian image_url sing diketik nganggo image_url.url disetel menyang URL HTTPS utawa URL data gambar sing didhukung. Dhukungan model dibutuhake.
providerobyekPreferensi routing panyedhiya opsional. Gunakake provider.only kanggo tag panyedhiya sing ditampa, dudu prefiks ing ID model. Watesan akun lan kredensial isih ditrapake.
allow_temporary_retentionbooleanVideo mung. Explicit true ngidini retensi asil sementara ing rute sing mbutuhake. Omitted/false njaga rute kasebut ora kasedhiya. Konflik karo provider.zdr:true; operasi liyane njaga ZDR wajib.

Maca asil#

Sukses bali HTTP 202 karo JSON. Kiriman bali HTTP 202 karo ShareAI ID tugas lan polling URL. Kirim header stabil Idempotency-Key stabil kanggo nyoba ulang panjalukan sing padha. Nggunakake kunci kuwi karo input beda ditolak. Polling GET /api/v1/videos/{id} nganggo kredensial asal sing padha. Status kalebu queued, pending, in_progress, finalizing, completed, failed lan requires_review. Asil requires_review butuh rekonsiliasi tim; polling ora tau miwiti generasi anyar.

Unit tagihan#

Rute video ngumumake unit sing ditagih. Rute per-detik diselesaikan nggunakake durasi sing diukur saka saben file sing bali, ora tau durasi sing dijaluk utawa biaya USD hulu. Durasi sing dijaluk kudu antarane 1 lan 600 detik lan didhukung dening model. Kredit konservatif bisa nutupi nganti papat output.

Pilih identifier model sing diaktifake kanthi tepat saka Console. Operasi sing diumumake lan kemampuan input/output kudu cocog karo endpoint iki; model obrolan teks ora bisa diganti kanggo operasi liyane. Watesan kredensial, panyedhiya lan akun sampeyan isih ditrapake.

Harga lan panggunaan#

Tarif diterbitake ing kredit AI EUR kanggo model sing dipilih, panyedhiya, unit lan varian. Mung dimensi ing tarif aktif sing dikenani biaya. Perkiraan nyimpen kredit sadurunge eksekusi; biaya pungkasan nggunakake panggunaan sing diukur. Harga bisa gumantung saka resolusi, format output utawa pita panggunaan. Priksa Console Usage kanggo debit ShareAI pungkasan. Lapangan biaya hulu lan byte media ora dikonversi dadi jumlah token sing diada-adakan.

Akses lan kesalahan#

Gunakake inference kanggo inferensi biaya jaringan sing disetujui utawa monetization_gateway kanggo markup Builder sing disetujui lan syarat tagihan sing ditampa. Akses identitas mung ora ngidini pengeluaran. Validasi, otorisasi model, kredit sing ora cukup, watesan tarif lan kegagalan eksekusi ngasilake error. Sawise timeout utawa kiriman sing ora pasti, priksa Usage utawa tugas video sadurunge nggawe panjalukan liyane sing bisa dikenani biaya.

Retensi video sementara#

Sawetara rute video butuh retensi sementara hulu supaya asil sing digawe bisa dijupuk. Iki mbutuhake panriman eksplisit allow_temporary_retention:true ing panjalukan video kasebut. Ngilangi iku njaga rute kasebut ora kasedhiya. Pangecualian iki mung ditrapake kanggo video lan ora tau ngidini latihan model utawa retensi kanggo operasi liyane. Kebijakan ZDR eksplisit ora bisa dilemahake kanthi diam-diam.

JSON

{"allow_temporary_retention": true}

Priksa status tugas#

GET https://api.shareai.now/api/v1/videos/{id}

Waca generasi video nganggo kredensial asalé

URL Dasar
https://api.shareai.now
Otentikasi
Bearer API key utawa token akses OAuth sing disetujui
Lingkup sing dibutuhake
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 ing ndhuwur nggambarake lapangan tugas sing stabil, ora generasi nyata. Polling jalur ShareAI nganggo kunci sing padha, ngenteni antarane pemeriksaan. queued, pending, in_progress lan finalizing tegese ngenteni; completed mbukak data karo URL konten ShareAI; failed lan requires_review tegese mandheg lan mriksa. Status nyoba ulang maca sawise kesalahan sementara, nanging aja ngirim ulang generasi kanthi otomatis. Kredensial sing beda utawa dicabut ora bisa njupuk tugas kasebut.

cURL

curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID" \
  -H "Authorization: Bearer $SHAREAI_API_KEY"

Unduh asilé#

Nalika rampung, saben entri data ngemot URL konten ShareAI. Fetch GET /api/v1/videos/{id}/content?index=0 nggunakake kredensial asal sing padha. Endpoint ndhukung siji HTTP byte range. URL Provider, tiket pribadi lan kredensial provider ora tau bali. Polling lan ngundhuh ora nggawe panjalukan inferensi kaping pindho utawa biaya Monetization Gateway ingestion. Pekerjaan sing rampung tegese penyelesaian dikonfirmasi sadurunge file bisa diundhuh.

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 opsional kudu ngemot bagean image_url kanthi first_frame utawa last_frame. Gunakake gambar frame utawa gambar referensi ing siji panjalukan, ora loro-lorone. Durasi model, resolusi lan rasio aspek bisa luwih mbatesi tinimbang watesan safety API. Webhooks lan URL callback sembarang ora didhukung.

Pungkasan dianyari 3 Novèmber 2026

Dokumen Platform ShareAI
Kabeh dokumentasi

Telusuri miturut judhul utawa isi.

Takon babagan kaca iki

Pilih asisten kanggo njelajah kaca iki. Sampeyan uga bisa nyalin kaca lan nempelake menyang obrolan sampeyan.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI