Bumuo ng isang imahe

Gamitin ang isang modelo ng imahe na kasalukuyang pinagana sa ShareAI at pinapayagan ng iyong kredensyal. Ang modelo ang nagtatakda kung aling mga laki, antas ng kalidad at mga opsyon sa output ang sinusuportahan nito.

Magpadala ng kahilingan#

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

Mga field ng kahilingan#

Basahin ang imahe#

Suriin ang ibinalik na data mga entry. Depende sa modelo at hiniling na format, ang isang entry ay naglalaman ng isang HTTPS image URL o base64 na data ng imahe. Gamitin ang aktwal na ibinalik na format; huwag ipagpalagay na ang bawat provider ay nagbabalik ng URL. Ang API ay hindi nagda-download ng mga ibinalik na URL ng imahe para sa iyo.

Mga limitasyon sa laki at oras#

Ang mga request ay synchronous. Ang pinagsamang teksto ay limitado sa 256 KiB, ang tawag sa provider sa 120 segundo at ang tugon sa 2 MiB. Ang malalaking base64 na imahe ay maaaring lumampas sa limitasyon ng tugon na iyon. Pumili ng angkop na laki ng output o isang modelo na sumusuporta sa output ng URL.

Mag-ingat sa pag-retry#

Ang pagbuo ng isang imahe ay maaaring magdulot ng paggamit. Pagkatapos ng timeout o hindi malinaw na pagkabigo ng network, suriin ang aktibidad bago mag-retry; ang pag-ulit ng request ay maaaring magresulta sa pagbuo at pagsingil para sa isa pang imahe. Ang API ay hindi awtomatikong nagre-retry ng isang request ng imahe pagkatapos isumite sa isang provider.

Mga sinusuportahang operasyon#

Ang rutang ito ay bumubuo ng mga imahe mula sa teksto. Ang mga pag-edit ng imahe, mga variation, multipart uploads at streaming na pagbuo ng imahe ay hindi suportado. Ang kasalukuyang pagsingil ay nangangailangan ng isang compatible na kontrata sa paggamit ng token ng modelo/provider; ang mga provider na per-image-only ay maaaring hindi magamit.

Gamitin ang awtorisasyon ng customer#

Para sa isang aprubadong OAuth flow, ipadala ang access token bilang Bearer. Ang pagbuo ng imahe na pinondohan ng account ay nangangailangan ng surcharge at isang tinatanggap na plano ng paggamit. Ang lahat ng mga limitasyon ng modelo, provider at account ay nananatili.