ShareAI Platform Docs

Video oluştur

Gönderim, HTTP 202 ile bir ShareAI iş kimliği ve sorgulama URL'si döndürür.

Markdown olarak görüntüle
Bu sayfada
POST https://api.shareai.now/api/v1/videos

Video oluştur

Temel URL
https://api.shareai.now
Kimlik doğrulama
Bearer API anahtarı veya onaylanmış OAuth erişim jetonu
Gerekli kapsam
inference or monetization_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
}'

İstek alanları#

AlanTürAnlam ve sınırlar
model gereklimetin dizisiTam etkinleştirilmiş genel model tanımlayıcısı. Bu işlemi bildirmeli ve kimlik bilgileriniz tarafından izin verilmiş olmalıdır.
prompt gereklimetin 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.
durationtam sayıModel destekli çözünürlük seçici, en fazla 100 karakter; yayımlanmış tarife varyantıyla eşleşmelidir.
resolutionmetin dizisiModel destekli en-boy oranı seçici, en fazla 100 karakter.
aspect_ratiometin dizisiModel destekli çıktı boyutu, en fazla 100 karakter, örneğin 1024×1024. Her model bu seçeneği desteklemez.
sizemetin dizisiİsteğe bağlı video ses parçası seçici. Model desteği ve eşleşen tarife varyantı gereklidir.
generate_audiobooleanİ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.
seedtam 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_imagesdiziEn 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_referencesdiziSadece 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.
providernesneİ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_retentionbooleanBaş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#

GET 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
inference or monetization_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.mp4

Opsiyonel 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

ShareAI Platform Belgeleri
Tüm belgeler

Başlık veya içerik ile ara.

Bu sayfa hakkında soru sor

Bu sayfayı keşfetmek için bir asistan seçin. Ayrıca sayfayı kopyalayıp konuşmanıza yapıştırabilirsiniz.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI