Generează o imagine

Folosește un model de imagine activat pe ShareAI și permis de acreditivul tău. Modelul determină ce dimensiuni, niveluri de calitate și opțiuni de ieșire sunt acceptate.

Trimite o cerere#

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());

Câmpuri cerere#

Citește imaginea#

Inspectează data intrările returnate. În funcție de model și formatul solicitat, o intrare conține un URL HTTPS al imaginii sau datele imaginii în format base64. Folosește formatul efectiv returnat; nu presupune că fiecare furnizor returnează un URL. API-ul nu descarcă automat URL-urile imaginilor returnate pentru tine.

Limite de dimensiune și timp#

Solicitările sunt sincronizate. Textul combinat este limitat la 256 KiB, apelul către furnizor la 120 de secunde și răspunsul la 2 MiB. Imaginile mari în format base64 pot depăși această limită de răspuns. Selectează o dimensiune de ieșire potrivită sau un model care acceptă ieșirea prin URL.

Reîncearcă cu atenție#

Generarea unei imagini poate implica costuri. După un timeout sau o eroare ambiguă de rețea, verifică activitatea înainte de a reîncerca; repetarea solicitării poate genera și taxa pentru o altă imagine. API-ul nu reîncearcă automat o solicitare de imagine după trimiterea către un furnizor.

Operațiuni acceptate#

Această rută generează imagini din text. Editările imaginilor, variațiile, încărcările multipart și generarea de imagini în flux nu sunt acceptate. Facturarea actuală necesită un contract compatibil de utilizare a token-urilor model/furnizor; furnizorii exclusiv per-imagine pot fi indisponibili.

Folosește autorizarea clientului#

Pentru un flux OAuth aprobat, trimite tokenul de acces ca Bearer. Generarea de imagini finanțată din cont necesită surcharge și un plan de utilizare acceptat. Toate restricțiile model, furnizor și cont rămân în vigoare.