Ƙirƙiri hotuna
Amsar JSON mai daidaituwa tana ƙunshe da sakamakon hotuna a cikin data.
A wannan shafin
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
inferenceormonetization_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
}'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);Filayen buƙata#
| Filin | Nau'in | Ma'ana da iyakoki |
|---|---|---|
model wajibi | kirtani | Takamaiman mai gano samfurin jama'a da aka kunna. Dole ne a bayyana wannan aiki kuma takardun shaidarka su yarda da shi. |
prompt wajibi | kirtani | Tambayar ƙarni mara komai, mafi girma 256 KiB na rubutun UTF-8. |
n | lamba | Zaɓin adadin hotuna, 1–10; tsoho 1. Samfurinka na iya ba da damar ƙasa da haka. |
size | kirtani | Girman fitarwa da samfurin ke tallafawa, mafi girma haruffa 100, misali 1024×1024. Ba duk samfurori ke tallafawa wannan zaɓi ba. |
resolution | kirtani | Zaɓin ƙudurin da samfurin ke tallafawa, mafi girma haruffa 100; dole ne ya dace da bambancin farashin da aka buga. |
aspect_ratio | kirtani | Zaɓin rabo na bangare da samfurin ke tallafawa, mafi girma haruffa 100. |
quality | kirtani | Zaɓin ingancin da samfurin ke tallafawa, mafi yawan haruffa 100; na iya zaɓar wata ƙimar daban. |
response_format | kirtani | Tsarin amsawa da samfurin ke tallafawa, ba fiye da haruffa 100 ba. Aiki yana ƙayyade ko sakamakon zai kasance JSON ko binary. |
output_format | kirtani | Zaɓin tsarin fitarwa da samfurin ke tallafawa, mafi yawan haruffa 100. |
background | kirtani | Zaɓin bango na hoto idan samfurin ya tallafa. |
seed | lamba | Zaɓin iri na samfurin da ake tallafawa. Bidiyo yana buƙatar lamba mai kyau; maimaituwa tana dogara da mai aiwatarwa. |
input_references | jerin abubuwa | Mafi 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. |
provider | abu | Zaɓ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