Video oluştur
Gönderim, HTTP 202 ile bir ShareAI iş kimliği ve sorgulama URL'si döndürür.
Bu sayfada
https://api.shareai.now/api/v1/videosVideo oluştur
- Temel URL
https://api.shareai.now- Kimlik doğrulama
- Bearer API anahtarı veya onaylanmış OAuth erişim jetonu
- Gerekli kapsam
inferenceormonetization_gateway
Gönderim, bir ShareAI iş kimliği ve sorgulama URL'si ile HTTP 202 döndürür. Aynı isteğin tekrarları için sabit bir Idempotency-Key başlık gönderin. Farklı bir girişle bu anahtarı yeniden kullanmak reddedilir. Aynı kaynak kimlik bilgisiyle sorgulama yapın. Durumlar arasında sırada, beklemede, işleniyor, sonlandırılıyor, tamamlandı, başarısız ve inceleme_gerekiyor bulunur. İnceleme_gerekiyor sonucu ekip uzlaşması gerektirir; sorgulama asla başka bir üretim başlatmaz. GET /api/v1/videos/{id} Boş olmayan üretim istemi, en fazla 256 KiB UTF-8 metni.
Başlamadan önce#
SHAREAI_API_KEY'i sunucunuzda ayarlayın ve model yer tutucusunu şu anda etkin olan bir modelle değiştirin. API anahtarını tarayıcı kodunda asla ifşa etmeyin. Model, hesap, kimlik bilgisi ve sağlayıcı bu işlemi izin vermelidir. Aşağıdaki isteğe bağlı ayarlar model desteği gerektirir; API güvenlik sınırları, her modelin her değeri desteklediği anlamına gelmez.
Bir istek gönder#
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);İstek alanları#
| Alan | Tür | Anlam ve sınırlar |
|---|---|---|
model gerekli | metin dizisi | Tam etkinleştirilmiş genel model tanımlayıcısı. Bu işlemi bildirmeli ve kimlik bilgileriniz tarafından izin verilmiş olmalıdır. |
prompt gerekli | metin dizisi | İsteğe bağlı olarak, saniye cinsinden talep edilen video süresi 1–600 arasında olup, seçilen model tarafından daha fazla kısıtlanabilir. Gerçek döndürülen süreler, süre faturalandırmasını belirler. |
duration | tam sayı | Model destekli çözünürlük seçici, en fazla 100 karakter; yayımlanmış tarife varyantıyla eşleşmelidir. |
resolution | metin dizisi | Model destekli en-boy oranı seçici, en fazla 100 karakter. |
aspect_ratio | metin dizisi | Model destekli çıktı boyutu, en fazla 100 karakter, örneğin 1024×1024. Her model bu seçeneği desteklemez. |
size | metin dizisi | İsteğe bağlı video ses parçası seçici. Model desteği ve eşleşen tarife varyantı gereklidir. |
generate_audio | boolean | İsteğe bağlı model destekli tohum. Video için negatif olmayan bir tam sayı gereklidir; tekrarlanabilirlik yürütücüye bağlıdır. |
seed | tam sayı | En fazla iki image_url parçası, her biri frame_type olarak first_frame veya last_frame ile, tekrar olmadan. frame_images ve input_references birleştirilmemelidir. |
frame_images | dizi | En fazla 16 türlendirilmiş image_url parçası, image_url.url bir HTTPS URL'si veya desteklenen bir resim veri URL'si olarak ayarlanmış. Model desteği gereklidir. |
input_references | dizi | Sadece video. Açıkça true, geçici yukarı akış sonucu saklamasına izin verir; bu, gerekli rotalarda geçerlidir. Atlanmış/false, bu rotaları kullanılamaz durumda tutar. provider.zdr:true ile çelişir; diğer işlemler zorunlu ZDR'yi saklar. |
provider | nesne | İsteğe bağlı sağlayıcı yönlendirme tercihleri. Kabul edilen sağlayıcı etiketleri için provider.only kullanın, model kimliğinde bir ön ek olarak değil. Hesap ve kimlik bilgisi kısıtlamaları yine de geçerlidir. |
allow_temporary_retention | boolean | Başarı, JSON ile HTTP 202 döndürür. Gönderim, bir ShareAI iş kimliği ve sorgulama URL'si ile HTTP 202 döndürür. Sabit bir. |
Sonucu okuyun#
Video rotaları, faturalandırılan birimlerini açıklar. Saniye başına bir rota, her döndürülen dosyanın ölçülen süresine göre hesaplanır; asla talep edilen süreye veya yukarı akış USD maliyetine göre değil. Talep edilen süre 1 ile 600 saniye arasında olmalı ve model tarafından desteklenmelidir. Muhafazakar bir kredi tutarı, dört çıktıya kadar kapsayabilir. Idempotency-Key başlık gönderin. Farklı bir girişle bu anahtarı yeniden kullanmak reddedilir. Aynı kaynak kimlik bilgisiyle sorgulama yapın. Durumlar arasında sırada, beklemede, işleniyor, sonlandırılıyor, tamamlandı, başarısız ve inceleme_gerekiyor bulunur. İnceleme_gerekiyor sonucu ekip uzlaşması gerektirir; sorgulama asla başka bir üretim başlatmaz. GET /api/v1/videos/{id} Boş olmayan üretim istemi, en fazla 256 KiB UTF-8 metni.
Faturalandırma birimleri#
Bazı video rotaları, üretilen sonucun alınabilmesi için geçici yukarı akış saklaması gerektirir. Bu, video isteğinde açık.
Konsol'dan tam etkin model tanımlayıcısını seçin. Beyan edilen işlem ve giriş/çıkış yetenekleri bu uç noktayla eşleşmelidir; bir metin sohbet modeli başka bir işlem için değiştirilemez. Kimlik bilgileriniz, sağlayıcı ve hesap kısıtlamaları hala geçerlidir.
Fiyatlandırma ve kullanım#
Oranlar, seçilen model, sağlayıcı, birimler ve varyantlar için EUR AI kredisi olarak yayımlanır. Yalnızca aktif tarifesindeki boyutlar ücretlendirilir. Bir tahmin, yürütmeden önce kredileri ayırır; nihai ücretler ölçülen kullanıma göre hesaplanır. Fiyatlar çözünürlüğe, çıktı formatına veya bir kullanım bandına bağlı olabilir. Nihai ShareAI borçlandırmasını görmek için Konsol Kullanımı'nı kontrol edin. Yukarı akış maliyet alanları ve medya baytları, uydurulmuş token sayısına dönüştürülmez.
Erişim ve hatalar#
Kullan inference onaylanmış ağ maliyeti çıkarımı için veya monetization_gateway onaylanmış bir Builder kar marjı ve kabul edilen faturalandırma şartları için. Yalnızca kimlik doğrulama erişimi harcama yetkisi vermez. Doğrulama, model yetkilendirmesi, yetersiz kredi, oran sınırları ve yürütme hataları yapılandırılmış bir şekilde döner. error. Bir zaman aşımı veya belirsiz gönderimden sonra, başka bir potansiyel ücretli istek oluşturmadan önce Kullanımı veya video işini inceleyin.
Geçici video saklama#
bir kabul gerektirir. Bunu atlamak, bu rotaları kullanılamaz durumda tutar. Bu istisna yalnızca video için geçerlidir ve asla model eğitimi veya diğer işlemler için saklamaya izin vermez. Açık bir ZDR politikası sessizce zayıflatılamaz. allow_temporary_retention:true Bir video üretimini kaynak kimlik bilgisiyle okuyun.
JSON
{"allow_temporary_retention": true}İş durumu kontrol et#
https://api.shareai.now/api/v1/videos/{id}Yukarıdaki JSON, sabit iş alanlarını gösterir, gerçek bir üretimi değil. Aynı anahtarla ShareAI yolunu sorgulayın, kontroller arasında bekleyin. sırada, beklemede, işleniyor ve sonlandırılıyor durumları bekle anlamına gelir; tamamlandı, ShareAI içerik URL'leriyle verileri gösterir; başarısız ve inceleme_gerekiyor durdur ve incele anlamına gelir. Geçici hatalardan sonra durumu yeniden deneyin, ancak üretimi otomatik olarak yeniden göndermeyin. Farklı veya iptal edilmiş bir kimlik bilgisi işi geri getiremez.
- Temel URL
https://api.shareai.now- Kimlik doğrulama
- Bearer API anahtarı veya onaylanmış OAuth erişim jetonu
- Gerekli kapsam
inferenceormonetization_gateway
JSON
{
"id": "YOUR_JOB_ID",
"object": "video",
"status": "pending",
"created_at": 1793664000,
"polling_url": "/api/v1/videos/YOUR_JOB_ID"
}Tamamlandığında, her veri girişi bir ShareAI içerik URL'si içerir. Alın.
cURL
curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID" \
-H "Authorization: Bearer $SHAREAI_API_KEY"Sonucu indir#
Tamamlandığında, her veri girişi bir ShareAI içerik URL'si içerir. Al GET /api/v1/videos/{id}/content?index=0 aynı kaynak kimlik bilgilerini kullanarak. Uç nokta yalnızca tek bir HTTP bayt aralığını destekler. Provider URL'leri, özel biletler ve provider kimlik bilgileri asla geri döndürülmez. Sorgulama ve indirme, ikinci bir çıkarım isteği veya Monetization Gateway işleme ücreti oluşturmaz. Tamamlanmış bir iş, dosya indirilebilir hale gelmeden önce ödemenin onaylandığı anlamına gelir.
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.mp4Opsiyonel frame_images, first_frame veya last_frame içeren image_url parçalarını içermelidir. Bir istekte çerçeve görüntüleri veya referans görüntüleri kullanın, ikisini birden değil. Model süreleri, çözünürlükleri ve en-boy oranları API'nin güvenlik sınırlarından daha kısıtlayıcı olabilir. Webhook'lar ve rastgele geri çağırma URL'leri desteklenmez.
Son güncelleme Kasım 3, 2026