Görüntü oluştur
Eşzamanlı JSON yanıtı, verilerdeki görüntü sonuçlarını içerir.
Bu sayfada
https://api.shareai.now/api/v1/imagesGörüntü oluştur
- Temel URL
https://api.shareai.now- Kimlik doğrulama
- Bearer API anahtarı veya onaylanmış OAuth erişim jetonu
- Gerekli kapsam
inferenceormonetization_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
}'Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_IMAGES_MODEL',
'prompt': 'A quiet forest painted in watercolor.',
'n': 1}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/images', 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/images", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_IMAGES_MODEL",
"prompt": "A quiet forest painted in watercolor.",
"n": 1
}),
});
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. |
n | tam sayı | İsteğe bağlı görüntü sayısı, 1–10; varsayılan 1. Modeliniz daha azına izin verebilir. |
size | metin dizisi | İsteğe bağlı video ses parçası seçici. Model desteği ve eşleşen tarife varyantı gereklidir. |
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. |
quality | metin dizisi | Model destekli kalite seçici, en fazla 100 karakter; farklı bir oran seçilebilir. |
response_format | metin dizisi | Model destekli yanıt formatı, en fazla 100 karakter. İşlem, sonucun JSON mu yoksa ikili mi olduğunu belirler. |
output_format | metin dizisi | Model destekli çıktı kodlama seçici, en fazla 100 karakter. |
background | metin dizisi | Model tarafından desteklendiğinde isteğe bağlı görüntü arka plan ayarı. |
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. |
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. |
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