ShareAI Platform Docs

Ƙirƙiri hotuna

Amsar JSON mai daidaituwa tana ƙunshe da sakamakon hotuna a cikin data.

Duba azaman Markdown
A wannan shafin
POST https://api.shareai.now/api/v1/images

Ƙirƙiri hotuna

URL na Asali
https://api.shareai.now
Tantancewa
Maɓallin API na Bearer ko takardar izinin shiga OAuth da aka amince da ita
Dole ne a sami izini
inference or monetization_gateway

Amsar JSON na lokaci guda yana ƙunshe da sakamakon hotuna a cikin data. Sunan lakabi /api/v1/images/generations ana tallafawa kuma. Zaɓuɓɓuka kamar girma, ƙuduri, rabo-tsari, inganci da tsarin fitarwa suna dogara da samfurin da aka zaɓa. Amsoshi suna iyakance zuwa 2 MiB; rage yawan hotuna ko girma idan ya zama dole. Hotunan da aka dawo sun iyakance zuwa 8192 pixels a kowane gefe.

Kafin ka fara#

Saita SHAREAI_API_KEY akan uwar garken ku kuma maye gurbin wurin samfurin samfurin da samfurin da aka kunna a halin yanzu. Kada ku taɓa bayyana maɓallin API a cikin lambar burauza. Samfurin, asusu, takaddun shaida da mai bayarwa dole ne duk su ba da izinin wannan aikin. Saitunan zaɓi a ƙasa suna buƙatar tallafin samfurin; iyakokin aminci na API ba alkawari bane cewa kowane samfurin yana tallafawa kowane ƙima.

Aika buƙata#

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

Filayen buƙata#

FilinNau'inMa'ana da iyakoki
model wajibikirtaniTakamaiman mai gano samfurin jama'a da aka kunna. Dole ne a bayyana wannan aiki kuma takardun shaidarka su yarda da shi.
prompt wajibikirtaniTambayar ƙarni mara komai, mafi girma 256 KiB na rubutun UTF-8.
nlambaZaɓin adadin hotuna, 1–10; tsoho 1. Samfurinka na iya ba da damar ƙasa da haka.
sizekirtaniGirman fitarwa da samfurin ke tallafawa, mafi girma haruffa 100, misali 1024×1024. Ba duk samfurori ke tallafawa wannan zaɓi ba.
resolutionkirtaniZaɓin ƙudurin da samfurin ke tallafawa, mafi girma haruffa 100; dole ne ya dace da bambancin farashin da aka buga.
aspect_ratiokirtaniZaɓin rabo na bangare da samfurin ke tallafawa, mafi girma haruffa 100.
qualitykirtaniZaɓin ingancin da samfurin ke tallafawa, mafi yawan haruffa 100; na iya zaɓar wata ƙimar daban.
response_formatkirtaniTsarin amsawa da samfurin ke tallafawa, ba fiye da haruffa 100 ba. Aiki yana ƙayyade ko sakamakon zai kasance JSON ko binary.
output_formatkirtaniZaɓin tsarin fitarwa da samfurin ke tallafawa, mafi yawan haruffa 100.
backgroundkirtaniZaɓin bango na hoto idan samfurin ya tallafa.
seedlambaZaɓin iri na samfurin da ake tallafawa. Bidiyo yana buƙatar lamba mai kyau; maimaituwa tana dogara da mai aiwatarwa.
input_referencesjerin abubuwaMafi yawan sassa 16 na image_url da aka rubuta tare da image_url.url da aka saita zuwa URL na HTTPS ko URL na bayanan hoto da aka tallafawa. Ana buƙatar tallafin samfurin.
providerabuZaɓin fifikon hanyar mai bayarwa. Yi amfani da provider.only don alamun mai bayarwa da aka karɓa, ba don farkon ID na samfur ba. Har yanzu ana amfani da iyakokin asusu da takardun shaida.

Karanta sakamakon#

Nasara tana dawowa da HTTP 200 tare da JSON. Amsar JSON na lokaci guda tana ƙunshe da sakamakon hotuna a cikin data. Sunan lakabi /api/v1/images/generations ana tallafawa kuma. Zaɓuɓɓuka kamar girma, ƙuduri, rabo-tsari, inganci da tsarin fitarwa suna dogara da samfurin da aka zaɓa. Amsoshi suna iyakance zuwa 2 MiB; rage yawan hotuna ko girma idan ya zama dole. Hotunan da aka dawo sun iyakance zuwa 8192 pixels a kowane gefe.

Rukunin biyan kuɗi#

Farashin hotuna na iya amfani da hotunan da aka samar, auna megapixels, bayanan shigarwa, buƙatu ko alamomin da mai bayarwa ya bayar. URL ɗin hoto ba ma'aunin girman hoto bane. Farashin megapixel yana buƙatar girman hoton da aka dawo; yi amfani da fitarwa na base64 don waɗannan hanyoyin.

Zaɓi ainihin mai gano samfurin da aka kunna daga Console. Ayyukansa da damar shigarwa/fitarwa da aka bayyana dole ne su dace da wannan wurin; samfurin hira da rubutu ba za a iya maye gurbinsa da wani aiki ba. Takaddun shaida, mai bayarwa da iyakokin asusunku har yanzu suna aiki.

Farashi da amfani#

Farashin ana wallafa su a cikin EUR AI credits don samfurin da aka zaɓa, mai bayarwa, raka'o'i da bambance-bambance. Ana cajin kawai girman da ke cikin farashin aiki. Kimantawa yana adana credits kafin aiwatarwa; cajin ƙarshe yana amfani da amfani da aka auna. Farashin na iya dogara da ƙuduri, tsarin fitarwa ko rukuni na amfani. Duba Console Usage don ShareAI debit na ƙarshe. Filayen farashin sama da bytes na kafofin watsa labarai ba a canza su zuwa adadin tokon da aka ƙirƙira ba.

Samuwa da kurakurai#

Amfani inference don amincewa da farashin hanyar sadarwa ko monetization_gateway don amincewa da ƙarin Builder da sharuɗɗan biyan kuɗi da aka karɓa. Samun izini kawai ba ya ba da izinin kashe kuɗi. Tabbatarwa, izinin samfurin, ƙarancin credits, iyakokin farashi da gazawar aiwatarwa suna dawo da tsari error. Bayan lokaci ko gabatarwa mara tabbas, bincika Amfani ko aikin bidiyo kafin ƙirƙirar wata buƙata mai yiwuwa da aka biya.

An sabunta karshe Nuwamba 3, 2026

Takardun Dandalin ShareAI
Duk takardu

Nemo ta taken ko abun ciki.

Tambayi game da wannan shafin

Zaɓi mataimaki don bincika wannan shafin. Hakanan za ku iya kwafa shafin ku liƙa shi cikin tattaunawarku.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI