Menghasilkan video
Pengiriman mengembalikan HTTP 202 dengan ID pekerjaan ShareAI dan URL polling.
Di halaman ini
https://api.shareai.now/api/v1/videosMenghasilkan video
- URL Dasar
https://api.shareai.now- Otentikasi
- Kunci API Bearer atau token akses OAuth yang disetujui
- Cakupan yang diperlukan
inferenceormonetization_gateway
Pengiriman mengembalikan HTTP 202 dengan ShareAI job ID dan polling URL. Kirim Idempotency-Key header stabil untuk pengulangan permintaan yang sama. Penggunaan ulang kunci tersebut dengan input berbeda akan ditolak. Polling GET /api/v1/videos/{id} dengan kredensial asal yang sama. Status mencakup queued, pending, in_progress, finalizing, completed, failed, dan requires_review. Hasil requires_review memerlukan rekonsiliasi tim; polling tidak pernah memulai generasi lain.
Sebelum Anda memulai#
Atur SHAREAI_API_KEY di server Anda dan ganti placeholder model dengan model yang saat ini diaktifkan. Jangan pernah mengekspos kunci API dalam kode browser. Model, akun, kredensial, dan penyedia semuanya harus mengizinkan operasi ini. Pengaturan opsional di bawah ini memerlukan dukungan model; batas keamanan API bukanlah janji bahwa setiap model mendukung setiap nilai.
Kirim permintaan#
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);Bidang permintaan#
| Bidang | Tipe | Makna dan batasan |
|---|---|---|
model diperlukan | string | Pengidentifikasi model publik yang diaktifkan secara tepat. Harus mendeklarasikan operasi ini dan diizinkan oleh kredensial Anda. |
prompt diperlukan | string | Prompt generasi tidak kosong, maksimal 256 KiB teks UTF-8. |
duration | bilangan bulat | Durasi video yang diminta secara opsional dalam detik, 1–600, dibatasi lebih lanjut oleh model yang dipilih. Durasi aktual yang dikembalikan menentukan penagihan durasi. |
resolution | string | Pemilih resolusi yang didukung model, maksimal 100 karakter; harus sesuai dengan varian tarif yang dipublikasikan. |
aspect_ratio | string | Pemilih rasio aspek yang didukung model, maksimal 100 karakter. |
size | string | Ukuran keluaran yang didukung model, maksimal 100 karakter, misalnya 1024×1024. Tidak semua model mendukung opsi ini. |
generate_audio | boolean | Pemilih soundtrack video opsional. Dukungan model dan varian tarif yang sesuai diperlukan. |
seed | bilangan bulat | Seed opsional yang didukung model. Video memerlukan bilangan bulat non-negatif; reprodusibilitas bergantung pada eksekutor. |
frame_images | array | Maksimal dua bagian image_url, masing-masing dengan frame_type first_frame atau last_frame, tanpa duplikasi. Jangan gabungkan frame_images dan input_references. |
input_references | array | Maksimal 16 bagian image_url yang diketik dengan image_url.url diatur ke URL HTTPS atau URL data gambar yang didukung. Dukungan model diperlukan. |
provider | objek | Preferensi routing penyedia opsional. Gunakan provider.only untuk tag penyedia yang diterima, bukan awalan dalam ID model. Pembatasan akun dan kredensial tetap berlaku. |
allow_temporary_retention | boolean | Hanya video. Nilai true secara eksplisit mengizinkan retensi hasil sementara di jalur yang membutuhkannya. Jika dihilangkan/false, jalur tersebut tetap tidak tersedia. Bertentangan dengan provider.zdr:true; operasi lain mempertahankan ZDR wajib. |
Baca hasilnya#
Keberhasilan mengembalikan HTTP 202 dengan JSON. Pengiriman mengembalikan HTTP 202 dengan ShareAI job ID dan polling URL. Kirim Idempotency-Key header stabil untuk pengulangan permintaan yang sama. Penggunaan ulang kunci tersebut dengan input berbeda akan ditolak. Polling GET /api/v1/videos/{id} dengan kredensial asal yang sama. Status mencakup queued, pending, in_progress, finalizing, completed, failed, dan requires_review. Hasil requires_review memerlukan rekonsiliasi tim; polling tidak pernah memulai generasi lain.
Unit penagihan#
Jalur video mendeklarasikan unit yang ditagih. Jalur per detik diselesaikan menggunakan durasi yang diukur dari setiap file yang dikembalikan, bukan durasi yang diminta atau biaya USD upstream. Durasi yang diminta harus antara 1 dan 600 detik dan didukung oleh model. Penahanan kredit konservatif dapat mencakup hingga empat output.
Pilih pengidentifikasi model yang diaktifkan secara tepat dari Console. Operasi yang dideklarasikan dan kemampuan input/output-nya harus sesuai dengan endpoint ini; model chat teks tidak dapat diganti untuk operasi lain. Pembatasan kredensial, penyedia, dan akun Anda tetap berlaku.
Harga dan penggunaan#
Tarif diterbitkan dalam kredit AI EUR untuk model, penyedia, unit, dan varian yang dipilih. Hanya dimensi dalam tarif aktifnya yang dikenakan biaya. Perkiraan akan memesan kredit sebelum eksekusi; biaya akhir menggunakan penggunaan yang terukur. Harga dapat bergantung pada resolusi, format output, atau rentang penggunaan. Periksa Penggunaan di Console untuk debit ShareAI akhir. Bidang biaya hulu dan byte media tidak diubah menjadi jumlah token yang diciptakan.
Akses dan kesalahan#
Gunakan inference untuk inferensi biaya jaringan yang disetujui atau monetization_gateway untuk markup Builder yang disetujui dan ketentuan penagihan yang diterima. Akses hanya identitas tidak mengizinkan pengeluaran. Validasi, otorisasi model, kredit yang tidak mencukupi, batasan tarif, dan kegagalan eksekusi mengembalikan struktur error. Setelah batas waktu atau pengiriman yang tidak pasti, periksa Penggunaan atau pekerjaan video sebelum membuat permintaan lain yang mungkin berbayar.
Retensi video sementara#
Beberapa jalur video memerlukan retensi sementara upstream agar hasil yang dihasilkan dapat diambil. Mereka memerlukan allow_temporary_retention:true persetujuan eksplisit Anda pada permintaan video tersebut. Menghilangkannya membuat jalur tersebut tidak tersedia. Pengecualian ini hanya berlaku untuk video dan tidak pernah mengizinkan pelatihan model atau retensi untuk operasi lain. Kebijakan ZDR eksplisit tidak dapat dilemahkan secara diam-diam.
JSON
{"allow_temporary_retention": true}Periksa status pekerjaan#
https://api.shareai.now/api/v1/videos/{id}Baca generasi video dengan kredensial asalnya
- URL Dasar
https://api.shareai.now- Otentikasi
- Kunci API Bearer atau token akses OAuth yang disetujui
- Cakupan yang diperlukan
inferenceormonetization_gateway
JSON
{
"id": "YOUR_JOB_ID",
"object": "video",
"status": "pending",
"created_at": 1793664000,
"polling_url": "/api/v1/videos/YOUR_JOB_ID"
}JSON di atas menggambarkan bidang pekerjaan yang stabil, bukan generasi nyata. Polling jalur ShareAI dengan kunci yang sama, menunggu di antara pemeriksaan. queued, pending, in_progress, dan finalizing berarti menunggu; completed menampilkan data dengan URL konten ShareAI; failed dan requires_review berarti berhenti dan periksa. Status pengulangan dibaca setelah kesalahan sementara, tetapi jangan kirim ulang generasi secara otomatis. Kredensial yang berbeda atau dicabut tidak dapat mengambil pekerjaan.
cURL
curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID" \
-H "Authorization: Bearer $SHAREAI_API_KEY"Unduh hasilnya#
Ketika selesai, setiap entri data berisi URL konten ShareAI. Ambil GET /api/v1/videos/{id}/content?index=0 menggunakan kredensial asal yang sama. Endpoint mendukung satu rentang byte HTTP. URL penyedia, tiket pribadi, dan kredensial penyedia tidak pernah dikembalikan. Polling dan pengunduhan tidak menciptakan permintaan inferensi kedua atau biaya Monetization Gateway. Pekerjaan yang selesai berarti penyelesaian dikonfirmasi sebelum file dapat diunduh.
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 opsional harus berisi bagian image_url dengan first_frame atau last_frame. Gunakan frame images atau reference images dalam satu permintaan, bukan keduanya. Durasi model, resolusi, dan rasio aspek dapat lebih terbatas dibandingkan batas keamanan API. Webhooks dan URL callback arbitrer tidak didukung.
Terakhir diperbarui 3 November 2026