Bir görsel oluştur

Şu anda ShareAI'de etkinleştirilmiş ve kimlik bilgileriniz tarafından izin verilen bir görsel modelini kullanın. Model, desteklediği boyutları, kalite seviyelerini ve çıktı seçeneklerini belirler.

Bir istek gönder#

curl --fail-with-body --request POST \
  "https://api.shareai.now/api/v1/images/generations" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_IMAGE_MODEL",
  "prompt": "A quiet forest painted in watercolor.",
  "n": 1,
  "size": "1024x1024"
}'

import json
import os
import urllib.request

headers = {"Authorization": "Bearer " + os.environ["SHAREAI_API_KEY"]}
headers["Content-Type"] = "application/json"
payload = {'model': 'YOUR_IMAGE_MODEL', 'prompt': 'A quiet forest painted in watercolor.', 'n': 1, 'size': '1024x1024'}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/images/generations', data=data, headers=headers, method='POST')
with urllib.request.urlopen(request, timeout=180) as response:
    print(json.load(response))

const url = "https://api.shareai.now/api/v1/images/generations";
const headers: Record = {
  Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
  "model": "YOUR_IMAGE_MODEL",
  "prompt": "A quiet forest painted in watercolor.",
  "n": 1,
  "size": "1024x1024"
};
const response = await fetch(url, { method: "POST", headers, body: JSON.stringify(payload) });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());

İstek alanları#

Görseli oku#

Döndürülen data girişleri inceleyin. Modele ve talep edilen formata bağlı olarak, bir giriş bir HTTPS görsel URL'si veya base64 görsel verisi içerir. Döndürülen gerçek formatı kullanın; her sağlayıcının bir URL döndüreceğini varsaymayın. API, döndürülen görsel URL'lerini sizin için indirmez.

Boyut ve zamanlama sınırları#

İstekler eşzamanlıdır. Birleştirilmiş metin 256 KiB ile sınırlıdır, sağlayıcı çağrısı 120 saniye ve yanıt 2 MiB ile sınırlıdır. Büyük base64 görseller bu yanıt sınırını aşabilir. Uygun bir çıktı boyutu veya URL çıktısını destekleyen bir model seçin.

Dikkatlice yeniden dene#

Bir görsel oluşturmak kullanım gerektirebilir. Bir zaman aşımı veya belirsiz bir ağ hatasından sonra, yeniden denemeden önce etkinliği kontrol edin; isteği tekrarlamak başka bir görsel oluşturabilir ve ücretlendirebilir. API, bir sağlayıcıya gönderildikten sonra bir görsel isteğini otomatik olarak yeniden denemez.

Desteklenen işlemler#

Bu rota metinden görseller oluşturur. Görsel düzenlemeleri, varyasyonlar, çok parçalı yüklemeler ve akışlı görsel oluşturma desteklenmez. Mevcut faturalandırma, uyumlu bir model/sağlayıcı belirteç kullanım sözleşmesi gerektirir; yalnızca görsel başına sağlayıcılar mevcut olmayabilir.

Müşteri yetkilendirmesini kullan#

Onaylanmış bir OAuth akışı için erişim belirtecini Bearer olarak gönderin. Hesap tarafından finanse edilen görsel oluşturma surcharge ve kabul edilen bir kullanım planı gerektirir. Tüm model, sağlayıcı ve hesap kısıtlamaları geçerliliğini korur.