Tengeneza picha
Jibu la JSON la wakati mmoja linajumuisha matokeo ya picha katika data.
Kwenye ukurasa huu
https://api.shareai.now/api/v1/imagesTengeneza picha
- URL ya Msingi
https://api.shareai.now- Uthibitishaji
- Funguo ya API ya Bearer au tokeni ya ufikiaji ya OAuth iliyokubaliwa
- Upeo unaohitajika
inferenceormonetization_gateway
Jibu la JSON la wakati mmoja linajumuisha matokeo ya picha katika data. Jina mbadala /api/v1/images/generations pia linaungwa mkono. Chaguo kama vile ukubwa, azimio, uwiano wa vipimo, ubora na muundo wa pato hutegemea mfano ulioteuliwa. Majibu yamewekewa kikomo cha 2 MiB; punguza idadi ya picha au ukubwa inapohitajika. Picha zilizorejeshwa zimewekewa kikomo cha pikseli 8192 kwa kila upande.
Kabla ya kuanza#
Weka SHAREAI_API_KEY kwenye seva yako na badilisha nafasi ya mfano na mfano uliowezeshwa kwa sasa. Kamwe usifunue API key kwenye msimbo wa kivinjari. Mfano, akaunti, kitambulisho na mtoa huduma lazima vyote viruhusu operesheni hii. Mipangilio ya hiari hapa chini inahitaji msaada wa mfano; mipaka ya usalama ya API si ahadi kwamba kila mfano unasaidia kila thamani.
Tuma ombi#
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);Sehemu za ombi#
| Sehemu | Aina | Maana na mipaka |
|---|---|---|
model inahitajika | kamba | Kitambulisho halisi cha mfano wa umma uliowezeshwa. Lazima kitangaze operesheni hii na kuruhusiwa na kitambulisho chako. |
prompt inahitajika | kamba | Maelezo ya kizazi yasiyo tupu, si zaidi ya 256 KiB ya maandishi ya UTF-8. |
n | nambari kamili | Idadi ya picha ya hiari, 1–10; chaguo-msingi ni 1. Mfano wako unaweza kuruhusu chache zaidi. |
size | kamba | Ukubwa wa pato unaoungwa mkono na mfano, si zaidi ya herufi 100, kwa mfano 1024×1024. Sio kila mfano unaounga mkono chaguo hili. |
resolution | kamba | Kichagua azimio kinachoungwa mkono na mfano, si zaidi ya herufi 100; lazima kilingane na toleo la ada lililochapishwa. |
aspect_ratio | kamba | Kichagua uwiano wa kipengele kinachoungwa mkono na mfano, si zaidi ya herufi 100. |
quality | kamba | Kichagua ubora kinachoungwa mkono na mfano, herufi zisizozidi 100; kinaweza kuchagua kiwango tofauti. |
response_format | kamba | Muundo wa majibu unaoungwa mkono na mfano, usiozidi herufi 100. Operesheni huamua kama matokeo ni JSON au binary. |
output_format | kamba | Kichagua usimbaji wa pato unaoungwa mkono na mfano, herufi zisizozidi 100. |
background | kamba | Mpangilio wa mandharinyuma ya picha wa hiari unapoungwa mkono na mfano. |
seed | nambari kamili | Mbegu inayoungwa mkono na mfano kwa hiari. Video inahitaji nambari isiyo hasi; urudufishaji unategemea mtekelezaji. |
input_references | safu | Sehemu 16 za image_url zilizoainishwa kwa zaidi na image_url.url iliyowekwa kwa URL ya HTTPS au URL ya data ya picha inayoungwa mkono. Msaada wa mfano unahitajika. |
provider | kitu | Mapendeleo ya hiari ya uelekezaji wa mtoa huduma. Tumia provider.only kwa vitambulisho vya mtoa huduma vilivyokubaliwa, si kiambishi awali kwenye ID ya mfano. Vizuizi vya akaunti na kitambulisho bado vinatumika. |
Soma matokeo#
Mafanikio yanarudisha HTTP 200 na JSON. Jibu la JSON la wakati mmoja linajumuisha matokeo ya picha katika data. Jina mbadala /api/v1/images/generations pia linaungwa mkono. Chaguo kama vile ukubwa, azimio, uwiano wa vipimo, ubora na muundo wa pato hutegemea mfano ulioteuliwa. Majibu yamewekewa kikomo cha 2 MiB; punguza idadi ya picha au ukubwa inapohitajika. Picha zilizorejeshwa zimewekewa kikomo cha pikseli 8192 kwa kila upande.
Vitengo vya malipo#
Ada za picha zinaweza kutumia picha zilizotengenezwa, megapikseli zilizopimwa, marejeleo ya pembejeo, maombi au tokeni zilizoripotiwa na mtoa huduma. URL ya picha si kipimo cha ukubwa wa picha. Ada za megapikseli zinahitaji vipimo vya picha vilivyorejeshwa; tumia pato la base64 kwa njia hizo.
Chagua kitambulisho halisi cha mfano uliowezeshwa kutoka Console. Operesheni yake iliyotangazwa na uwezo wa pembejeo/pato lazima vilingane na endpoint hii; mfano wa mazungumzo ya maandishi hauwezi kubadilishwa kwa operesheni nyingine. Vizuizi vya kitambulisho, mtoa huduma na akaunti yako bado vinatumika.
Bei na matumizi#
Viwango vinachapishwa kwa EUR AI credits kwa mfano ulioteuliwa, mtoa huduma, vitengo na tofauti. Vipimo tu katika ada yake inayotumika vinatozwa. Makadirio yanahifadhi credits kabla ya utekelezaji; malipo ya mwisho hutumia matumizi yaliyopimwa. Bei zinaweza kutegemea azimio, muundo wa pato au kiwango cha matumizi. Angalia Console Usage kwa deni la mwisho la ShareAI. Sehemu za gharama za juu na baiti za vyombo vya habari hazibadilishwi kuwa hesabu za tokeni zilizobuniwa.
Ufikiaji na makosa#
Tumia inference kwa inference ya gharama ya mtandao iliyokubaliwa au monetization_gateway kwa markup ya Builder iliyokubaliwa na masharti ya malipo yaliyokubaliwa. Ufikiaji wa kitambulisho pekee hauidhinishi matumizi. Uthibitishaji, idhini ya mfano, credits zisizotosha, mipaka ya kiwango na kushindwa kwa utekelezaji hurudisha error. Baada ya muda wa kusubiri au uwasilishaji usio na uhakika, kagua Usage au kazi ya video kabla ya kuunda ombi lingine linaloweza kulipwa.
Ilisasishwa mwisho Novemba 3, 2026