ShareAI Platform Docs

Tengeneza picha

Jibu la JSON la wakati mmoja linajumuisha matokeo ya picha katika data.

Tazama kama Markdown
Kwenye ukurasa huu
POST https://api.shareai.now/api/v1/images

Tengeneza picha

URL ya Msingi
https://api.shareai.now
Uthibitishaji
Funguo ya API ya Bearer au tokeni ya ufikiaji ya OAuth iliyokubaliwa
Upeo unaohitajika
inference or monetization_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
}'

Sehemu za ombi#

SehemuAinaMaana na mipaka
model inahitajikakambaKitambulisho halisi cha mfano wa umma uliowezeshwa. Lazima kitangaze operesheni hii na kuruhusiwa na kitambulisho chako.
prompt inahitajikakambaMaelezo ya kizazi yasiyo tupu, si zaidi ya 256 KiB ya maandishi ya UTF-8.
nnambari kamiliIdadi ya picha ya hiari, 1–10; chaguo-msingi ni 1. Mfano wako unaweza kuruhusu chache zaidi.
sizekambaUkubwa wa pato unaoungwa mkono na mfano, si zaidi ya herufi 100, kwa mfano 1024×1024. Sio kila mfano unaounga mkono chaguo hili.
resolutionkambaKichagua azimio kinachoungwa mkono na mfano, si zaidi ya herufi 100; lazima kilingane na toleo la ada lililochapishwa.
aspect_ratiokambaKichagua uwiano wa kipengele kinachoungwa mkono na mfano, si zaidi ya herufi 100.
qualitykambaKichagua ubora kinachoungwa mkono na mfano, herufi zisizozidi 100; kinaweza kuchagua kiwango tofauti.
response_formatkambaMuundo wa majibu unaoungwa mkono na mfano, usiozidi herufi 100. Operesheni huamua kama matokeo ni JSON au binary.
output_formatkambaKichagua usimbaji wa pato unaoungwa mkono na mfano, herufi zisizozidi 100.
backgroundkambaMpangilio wa mandharinyuma ya picha wa hiari unapoungwa mkono na mfano.
seednambari kamiliMbegu inayoungwa mkono na mfano kwa hiari. Video inahitaji nambari isiyo hasi; urudufishaji unategemea mtekelezaji.
input_referencessafuSehemu 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.
providerkituMapendeleo 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

Nyaraka za Jukwaa la ShareAI
Nyaraka zote

Tafuta kwa kichwa au maudhui.

Uliza kuhusu ukurasa huu

Chagua msaidizi wa kuchunguza ukurasa huu. Unaweza pia kunakili ukurasa na kuubandika kwenye mazungumzo yako.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI