ShareAI Platform Docs

Generează imagini

Răspunsul JSON sincron conține rezultatele imaginilor în date.

Vizualizează ca Markdown
Pe această pagină
POST https://api.shareai.now/api/v1/images

Generează imagini

URL de bază
https://api.shareai.now
Autentificare
Cheie API Bearer sau token de acces OAuth aprobat
Scop necesar
inference or monetization_gateway

Răspunsul JSON sincron conține rezultatele imaginilor în data. Aliasul /api/v1/images/generations este de asemenea acceptat. Opțiuni precum dimensiune, rezoluție, aspect_ratio, calitate și formatul de ieșire depind de modelul selectat. Răspunsurile sunt limitate la 2 MiB; reduceți numărul sau dimensiunea imaginilor dacă este necesar. Imaginile returnate sunt limitate la 8192 pixeli pe fiecare latură.

Înainte de a începe#

Setează SHAREAI_API_KEY pe serverul tău și înlocuiește placeholder-ul modelului cu un model activat în prezent. Nu expune niciodată cheia API în codul browserului. Modelul, contul, acreditivul și providerul trebuie să permită această operațiune. Setările opționale de mai jos necesită suportul modelului; limitele de siguranță ale API-ului nu garantează că fiecare model suportă fiecare valoare.

Trimite o cerere#

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
}'

Câmpuri cerere#

CâmpTipSemnificație și limite
model necesarșirIdentificatorul exact al modelului public activat. Trebuie să declare această operațiune și să fie permis de acreditivul tău.
prompt necesarșirPrompt de generare non-gol, cel mult 256 KiB de text UTF-8.
nîntregNumăr opțional de imagini, 1–10; implicit 1. Modelul tău poate permite mai puține.
sizeșirDimensiunea de ieșire suportată de model, cel mult 100 de caractere, de exemplu 1024×1024. Nu fiecare model suportă această opțiune.
resolutionșirSelector de rezoluție suportată de model, cel mult 100 de caractere; trebuie să corespundă variantei tarifare publicate.
aspect_ratioșirSelector de raport de aspect suportat de model, cel mult 100 de caractere.
qualityșirSelector de calitate acceptat de model, cel mult 100 de caractere; poate selecta o rată diferită.
response_formatșirFormat de răspuns suportat de model, de cel mult 100 de caractere. Operațiunea determină dacă rezultatul este JSON sau binar.
output_formatșirSelector de codificare a ieșirii acceptat de model, cel mult 100 de caractere.
backgroundșirSetare opțională pentru fundalul imaginii atunci când este acceptată de model.
seedîntregSămânță suportată opțional de model. Videoclipul necesită un număr întreg nenegativ; reproducibilitatea depinde de executor.
input_referencesarrayCel mult 16 părți image_url tipizate cu image_url.url setat la un URL HTTPS sau un URL de date imagine suportat. Suportul modelului este necesar.
providerobiectPreferințe opționale de rutare ale providerului. Utilizează provider.only pentru tag-uri de provider acceptate, nu un prefix în ID-ul modelului. Restricțiile contului și acreditivului se aplică în continuare.

Citește rezultatul#

Succesul returnează HTTP 200 cu JSON. Răspunsul JSON sincron conține rezultatele imaginilor în data. Aliasul /api/v1/images/generations este de asemenea acceptat. Opțiuni precum dimensiune, rezoluție, aspect_ratio, calitate și formatul de ieșire depind de modelul selectat. Răspunsurile sunt limitate la 2 MiB; reduceți numărul sau dimensiunea imaginilor dacă este necesar. Imaginile returnate sunt limitate la 8192 pixeli pe fiecare latură.

Unități de facturare#

Tarifele pentru imagini pot utiliza imagini generate, megapixeli măsurați, referințe de intrare, cereri sau tokeni raportați de furnizor. Un URL de imagine nu reprezintă o măsurare a dimensiunii imaginii. Tarifele pe megapixeli necesită dimensiunile imaginilor returnate; utilizați ieșirea base64 pentru acele rute.

Alege identificatorul exact al modelului activat din Console. Operațiunea declarată și capacitățile de intrare/ieșire trebuie să se potrivească cu acest endpoint; un model de chat text nu poate fi substituit pentru o altă operațiune. Restricțiile acreditivului, providerului și contului tău se aplică în continuare.

Prețuri și utilizare#

Tarifele sunt publicate în credite AI EUR pentru modelul, providerul, unitățile și variantele selectate. Sunt taxate doar dimensiunile din tariful său activ. O estimare rezervă credite înainte de execuție; taxele finale utilizează utilizarea măsurată. Prețurile pot depinde de rezoluție, formatul de ieșire sau un interval de utilizare. Verifică Console Usage pentru debitul final ShareAI. Câmpurile de cost upstream și byte-urile media nu sunt convertite în număr de token inventat.

Acces și erori#

Utilizează inference pentru inferență aprobată cu costuri de rețea sau monetization_gateway pentru un adaos aprobat de Builder și termeni de facturare acceptați. Accesul doar pe bază de identitate nu autorizează cheltuieli. Validarea, autorizarea modelului, creditele insuficiente, limitele de rată și eșecurile de execuție returnează un error. După un timeout sau o trimitere incertă, inspectează Usage sau job-ul video înainte de a crea o altă cerere potențial plătită.

Ultima actualizare noiembrie 3, 2026

Documentația platformei ShareAI
Toată documentația

Caută după titlu sau conținut.

Întreabă despre această pagină

Alege un asistent pentru a explora această pagină. Poți, de asemenea, să copiezi pagina și să o inserezi în conversația ta.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI