ShareAI Platform Docs

Görüntü oluştur

Eşzamanlı JSON yanıtı, verilerdeki görüntü sonuçlarını içerir.

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

Görüntü 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

Eşzamanlı JSON yanıtı, görüntü sonuçlarını içerir data. Takma ad /api/v1/images/generations da desteklenir. Boyut, çözünürlük, en-boy oranı, kalite ve çıktı formatı gibi seçenekler seçilen modele bağlıdır. Yanıtlar 2 MiB ile sınırlıdır; gerektiğinde görüntü sayısını veya boyutunu azaltın. Döndürülen görüntüler bir kenarda en fazla 8192 piksel ile sınırlıdır.

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/images" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_ENABLED_IMAGES_MODEL",
  "prompt": "A quiet forest painted in watercolor.",
  "n": 1
}'

İ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.
ntam sayıİsteğe bağlı görüntü sayısı, 1–10; varsayılan 1. Modeliniz daha azına izin verebilir.
sizemetin dizisiİsteğe bağlı video ses parçası seçici. Model desteği ve eşleşen tarife varyantı gereklidir.
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.
qualitymetin dizisiModel destekli kalite seçici, en fazla 100 karakter; farklı bir oran seçilebilir.
response_formatmetin dizisiModel destekli yanıt formatı, en fazla 100 karakter. İşlem, sonucun JSON mu yoksa ikili mi olduğunu belirler.
output_formatmetin dizisiModel destekli çıktı kodlama seçici, en fazla 100 karakter.
backgroundmetin dizisiModel tarafından desteklendiğinde isteğe bağlı görüntü arka plan ayarı.
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.
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.

Sonucu okuyun#

Başarılı işlem, JSON ile birlikte HTTP 200 döndürür. Eşzamanlı JSON yanıtı, görüntü sonuçlarını içerir. data. Takma ad /api/v1/images/generations da desteklenir. Boyut, çözünürlük, en-boy oranı, kalite ve çıktı formatı gibi seçenekler seçilen modele bağlıdır. Yanıtlar 2 MiB ile sınırlıdır; gerektiğinde görüntü sayısını veya boyutunu azaltın. Döndürülen görüntüler bir kenarda en fazla 8192 piksel ile sınırlıdır.

Faturalandırma birimleri#

Görüntü tarifeleri, oluşturulan görüntüleri, ölçülen megapikselleri, giriş referanslarını, istekleri veya sağlayıcı tarafından raporlanan jetonları kullanabilir. Bir görüntü URL'si, görüntü boyutu ölçümü değildir. Megapiksel tarifeleri, döndürülen görüntü boyutlarını gerektirir; bu rotalar için base64 çıktısını kullanın.

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.

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