Bumuo ng mga imahe
Ang sabay-sabay na JSON na tugon ay naglalaman ng mga resulta ng imahe sa data.
Sa pahinang ito
https://api.shareai.now/api/v1/imagesBumuo ng mga imahe
- Base URL
https://api.shareai.now- Pagpapatunay
- Bearer API key o aprubadong OAuth access token
- Kinakailangang scope
inferenceormonetization_gateway
Ang sabay-sabay na JSON na tugon ay naglalaman ng mga resulta ng imahe sa data. Ang alias /api/v1/images/generations ay sinusuportahan din. Ang mga opsyon tulad ng laki, resolusyon, aspect_ratio, kalidad, at format ng output ay nakadepende sa napiling modelo. Ang mga tugon ay limitado sa 2 MiB; bawasan ang bilang ng imahe o laki kung kinakailangan. Ang mga ibinalik na imahe ay limitado sa 8192 pixels bawat gilid.
Bago ka magsimula#
Itakda ang SHAREAI_API_KEY sa iyong server at palitan ang placeholder ng modelo ng kasalukuyang pinapaganang modelo. Huwag kailanman ilantad ang API key sa browser code. Ang modelo, account, kredensyal, at provider ay dapat lahat pahintulutan ang operasyong ito. Ang mga opsyonal na setting sa ibaba ay nangangailangan ng suporta ng modelo; ang mga hangganan ng kaligtasan ng API ay hindi pangako na ang bawat modelo ay sumusuporta sa bawat halaga.
Magpadala ng kahilingan#
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);Mga field ng kahilingan#
| Patlang | Uri | Kahulugan at mga limitasyon |
|---|---|---|
model kinakailangan | string | Eksaktong pinapaganang pampublikong identifier ng modelo. Dapat ideklara ang operasyong ito at pahintulutan ng iyong kredensyal. |
prompt kinakailangan | string | Hindi walang laman na prompt ng pagbuo, hanggang sa 256 KiB ng UTF-8 na teksto. |
n | integer | Opsyonal na bilang ng imahe, 1–10; default ay 1. Maaaring mas kaunti ang pahintulutan ng iyong modelo. |
size | string | Sinusuportahan ng modelo ang laki ng output, hanggang sa 100 karakter, halimbawa 1024×1024. Hindi lahat ng modelo ay sumusuporta sa opsyong ito. |
resolution | string | Sinusuportahan ng modelo ang tagapili ng resolusyon, hanggang sa 100 karakter; dapat tumugma sa inilathalang variant ng taripa. |
aspect_ratio | string | Sinusuportahan ng modelo ang tagapili ng aspect ratio, hanggang sa 100 karakter. |
quality | string | Sinusuportahan ng modelo ang tagapili ng kalidad, hanggang sa 100 karakter; maaaring pumili ng ibang rate. |
response_format | string | Sinusuportahan ng modelo ang format ng tugon, hanggang sa 100 karakter. Ang operasyon ang nagtatakda kung ang resulta ay JSON o binary. |
output_format | string | Sinusuportahan ng modelo ang tagapili ng encoding ng output, hanggang sa 100 karakter. |
background | string | Opsyonal na setting ng background ng imahe kapag sinusuportahan ng modelo. |
seed | integer | Opsyonal na sinusuportahan ng modelo ang seed. Ang video ay nangangailangan ng hindi negatibong integer; ang reproducibility ay nakadepende sa executor. |
input_references | array | Hanggang sa 16 na bahagi ng image_url na may image_url.url na nakatakda sa isang HTTPS URL o sinusuportahang URL ng data ng imahe. Kinakailangan ang suporta ng modelo. |
provider | bagay | Opsyonal na mga kagustuhan sa pag-route ng provider. Gamitin ang provider.only para sa mga tinatanggap na tag ng provider, hindi isang prefix sa model ID. Ang mga paghihigpit sa account at kredensyal ay nalalapat pa rin. |
Basahin ang resulta#
Ang tagumpay ay nagbabalik ng HTTP 200 na may JSON. Ang sabay-sabay na JSON na tugon ay naglalaman ng mga resulta ng imahe sa data. Ang alias /api/v1/images/generations ay sinusuportahan din. Ang mga opsyon tulad ng laki, resolusyon, aspect_ratio, kalidad, at format ng output ay nakadepende sa napiling modelo. Ang mga tugon ay limitado sa 2 MiB; bawasan ang bilang ng imahe o laki kung kinakailangan. Ang mga ibinalik na imahe ay limitado sa 8192 pixels bawat gilid.
Mga yunit ng pagsingil#
Ang mga taripa ng imahe ay maaaring gumamit ng mga nabuong imahe, sinusukat na megapixels, mga input na reference, mga kahilingan, o mga token na iniulat ng provider. Ang isang URL ng imahe ay hindi sukat ng laki ng imahe. Ang mga taripa ng megapixel ay nangangailangan ng mga sukat ng ibinalik na imahe; gamitin ang base64 output para sa mga rutang iyon.
Piliin ang eksaktong pinapaganang identifier ng modelo mula sa Console. Ang idineklarang operasyon nito at mga kakayahan sa input/output ay dapat tumugma sa endpoint na ito; ang isang text chat model ay hindi maaaring palitan para sa ibang operasyon. Ang iyong kredensyal, provider, at mga paghihigpit sa account ay nalalapat pa rin.
Pagpepresyo at paggamit#
Ang mga rate ay inilathala sa EUR AI credits para sa napiling modelo, provider, mga yunit, at mga variant. Ang mga sukat lamang sa aktibong taripa nito ang sinisingil. Ang isang pagtatantya ay nagrereserba ng mga kredito bago ang pagpapatupad; ang mga huling singil ay gumagamit ng nasukat na paggamit. Ang mga presyo ay maaaring depende sa resolusyon, format ng output, o isang banda ng paggamit. Suriin ang Console Usage para sa huling ShareAI debit. Ang mga field ng gastos sa upstream at media bytes ay hindi iko-convert sa mga imbentong bilang ng token.
Pag-access at mga error#
Gamitin inference para sa aprubadong inference ng network-cost o monetization_gateway para sa isang aprubadong markup ng Builder at tinatanggap na mga tuntunin sa pagsingil. Ang access na identity-only ay hindi nagbibigay ng awtorisasyon sa paggastos. Ang validation, awtorisasyon ng modelo, hindi sapat na kredito, mga limitasyon sa rate, at mga pagkabigo sa pagpapatupad ay nagbabalik ng structured error. Pagkatapos ng timeout o hindi tiyak na pagsusumite, suriin ang Usage o ang video job bago lumikha ng isa pang posibleng bayad na kahilingan.
Huling na-update Nobyembre 3, 2026