படங்களை உருவாக்கவும்
ஒத்திசைந்த JSON பதில் தரவுகளில் பட முடிவுகளை கொண்டுள்ளது.
இந்த பக்கத்தில்
https://api.shareai.now/api/v1/imagesபடங்களை உருவாக்கவும்
- அடிப்படை URL
https://api.shareai.now- அங்கீகாரம்
- Bearer API முக்கியம் அல்லது அங்கீகரிக்கப்பட்ட OAuth அணுகல் டோக்கன்
- தேவையான அளவுரு
inferenceormonetization_gateway
ஒத்திசைந்த JSON பதில் பட முடிவுகளை கொண்டுள்ளது data. மாற்றுப்பெயர் /api/v1/images/generations கூடுதலாக ஆதரிக்கப்படுகிறது. அளவு, தீர்மானம், aspect_ratio, தரம் மற்றும் வெளியீட்டு வடிவம் போன்ற விருப்பங்கள் தேர்ந்தெடுக்கப்பட்ட மாடலின் அடிப்படையில் இருக்கும். பதில்கள் 2 MiB வரை மட்டுப்படுத்தப்பட்டுள்ளன; தேவையான போது பட எண்ணிக்கை அல்லது அளவை குறைக்கவும். திரும்பிய படங்கள் ஒவ்வொரு பக்கத்திலும் 8192 பிக்சல்களுக்கு மட்டுப்படுத்தப்பட்டுள்ளன.
நீங்கள் தொடங்குவதற்கு முன்#
SHAREAI_API_KEY ஐ உங்கள் சர்வரில் அமைக்கவும் மற்றும் மாடல் placeholder ஐ தற்போதைய செயல்பாட்டில் உள்ள மாடலுடன் மாற்றவும். API விசையை உலாவி குறியீட்டில் ஒருபோதும் வெளிப்படுத்த வேண்டாம். மாடல், கணக்கு, சான்று மற்றும் வழங்குநர் இந்த செயல்பாட்டை அனுமதிக்க வேண்டும். கீழே உள்ள விருப்ப அமைப்புகள் மாடல் ஆதரவை தேவைப்படும்; API பாதுகாப்பு வரம்புகள் ஒவ்வொரு மாடலும் ஒவ்வொரு மதிப்பையும் ஆதரிக்கிறது என்ற வாக்குறுதியல்ல.
ஒரு கோரிக்கையை அனுப்பவும்#
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);கோரிக்கை புலங்கள்#
| புலம் | வகை | பொருள் மற்றும் வரம்புகள் |
|---|---|---|
model தேவை | string | சரியான செயல்படுத்தப்பட்ட பொது மாடல் அடையாளம். இந்த செயல்பாட்டை அறிவிக்க வேண்டும் மற்றும் உங்கள் சான்றிதழால் அனுமதிக்கப்பட வேண்டும். |
prompt தேவை | string | காலியாக இல்லாத தலைமுறை prompt, அதிகபட்சம் 256 KiB UTF-8 உரை. |
n | முழு எண் | விருப்பமான பட எண்ணிக்கை, 1–10; இயல்புநிலை 1. உங்கள் மாடல் குறைவாக அனுமதிக்கலாம். |
size | string | மாடல் ஆதரவு வெளியீட்டு அளவு, அதிகபட்சம் 100 எழுத்துகள், உதாரணமாக 1024×1024. ஒவ்வொரு மாடலும் இந்த விருப்பத்தை ஆதரிக்காது. |
resolution | string | மாடல் ஆதரவு தீர்மான தேர்வாளர், அதிகபட்சம் 100 எழுத்துகள்; வெளியிடப்பட்ட கட்டண மாறுபாட்டுடன் பொருந்த வேண்டும். |
aspect_ratio | string | மாடல் ஆதரவு கோண விகித தேர்வாளர், அதிகபட்சம் 100 எழுத்துகள். |
quality | string | மாடல் ஆதரிக்கப்படும் தரத் தேர்வாளர், அதிகபட்சம் 100 எழுத்துகள்; வேறொரு விகிதத்தைத் தேர்ந்தெடுக்கலாம். |
response_format | string | மாடல் ஆதரிக்கப்படும் பதில் வடிவம், அதிகபட்சம் 100 எழுத்துகள். செயல்பாடு முடிவின் JSON அல்லது பைனரி என்பதைத் தீர்மானிக்கிறது. |
output_format | string | மாடல் ஆதரிக்கப்படும் வெளியீட்டு குறியாக்கத் தேர்வாளர், அதிகபட்சம் 100 எழுத்துகள். |
background | string | மாடல் ஆதரிக்கும்போது விருப்பமான பட பின்னணி அமைப்பு. |
seed | முழு எண் | விருப்பமாக மாடல் ஆதரவு விதை. வீடியோ ஒரு எதிர்மறை அல்லாத முழு எண்ணை தேவைப்படும்; மீளத்திறன் செயல்படுத்துபவரின் மீது निर्भर. |
input_references | வரிசை | அதிகபட்சம் 16 வகைப்படுத்தப்பட்ட image_url பகுதிகள் image_url.url HTTPS URL அல்லது ஆதரிக்கப்படும் image data URL ஆக அமைக்க வேண்டும். மாடல் ஆதரவு தேவைப்படும். |
provider | object | விருப்ப வழங்குநர் வழிமாற்று முன்னுரிமைகள். வழங்குநர்.only ஐ ஏற்றுக்கொள்ளப்பட்ட வழங்குநர் குறிச்சொற்களுக்கு பயன்படுத்தவும், மாடல் ID இல் முன்னொட்டாக அல்ல. கணக்கு மற்றும் சான்றிதழ் கட்டுப்பாடுகள் இன்னும் பொருந்தும். |
முடிவைப் படிக்கவும்#
வெற்றி HTTP 200 ஐ JSON உடன் திருப்புகிறது. ஒத்திசைந்த JSON பதில் பட முடிவுகளை கொண்டுள்ளது data. மாற்றுப்பெயர் /api/v1/images/generations கூடுதலாக ஆதரிக்கப்படுகிறது. அளவு, தீர்மானம், aspect_ratio, தரம் மற்றும் வெளியீட்டு வடிவம் போன்ற விருப்பங்கள் தேர்ந்தெடுக்கப்பட்ட மாடலின் அடிப்படையில் இருக்கும். பதில்கள் 2 MiB வரை மட்டுப்படுத்தப்பட்டுள்ளன; தேவையான போது பட எண்ணிக்கை அல்லது அளவை குறைக்கவும். திரும்பிய படங்கள் ஒவ்வொரு பக்கத்திலும் 8192 பிக்சல்களுக்கு மட்டுப்படுத்தப்பட்டுள்ளன.
கட்டண அலகுகள்#
பட வரி கட்டணங்கள் உருவாக்கப்பட்ட படங்களை, அளவிடப்பட்ட மெகாபிக்சல்களை, உள்ளீட்டு குறிப்புகளை, கோரிக்கைகளை அல்லது வழங்குநர்-அறிக்கையிடப்பட்ட டோக்கன்களைப் பயன்படுத்தலாம். ஒரு பட URL என்பது பட அளவின் அளவீடு அல்ல. மெகாபிக்சல் வரி கட்டணங்களுக்கு திரும்பிய பட பரிமாணங்கள் தேவை; அந்த வழித்தடங்களுக்கு base64 வெளியீட்டை பயன்படுத்தவும்.
Console இல் இருந்து சரியான செயல்பாட்டில் உள்ள மாடல் அடையாளத்தைத் தேர்ந்தெடுக்கவும். அதன் அறிவிக்கப்பட்ட செயல்பாடு மற்றும் உள்ளீடு/வெளியீட்டு திறன்கள் இந்த இறுதிப்புள்ளியுடன் பொருந்த வேண்டும்; ஒரு உரை உரையாடல் மாடலை மற்றொரு செயல்பாட்டிற்கு மாற்ற முடியாது. உங்கள் சான்று, வழங்குநர் மற்றும் கணக்கு கட்டுப்பாடுகள் இன்னும் பொருந்தும்.
விலை மற்றும் பயன்பாடு#
தேர்வுசெய்யப்பட்ட மாடல், வழங்குநர், அலகுகள் மற்றும் மாறுபாடுகளுக்கான விகிதங்கள் EUR AI கிரெடிட்களில் வெளியிடப்பட்டுள்ளன. அதன் செயலில் உள்ள கட்டண அளவுகளில் உள்ள பரிமாணங்களுக்கே கட்டணம் வசூலிக்கப்படும். ஒரு மதிப்பீடு செயல்படுத்துவதற்கு முன் கிரெடிட்களை முன்பதிவு செய்கிறது; இறுதி கட்டணங்கள் அளிக்கப்பட்ட பயன்பாட்டை பயன்படுத்துகின்றன. விலைகள் தீர்மானம், வெளியீட்டு வடிவம் அல்லது பயன்பாட்டு வரம்பின் அடிப்படையில் மாறக்கூடும். இறுதி ShareAI டெபிட் விவரங்களை Console Usage-ல் சரிபார்க்கவும். மேல்நிலை செலவுகள் மற்றும் மீடியா பைட்கள் கண்டுபிடிக்கப்பட்ட டோக்கன் எண்ணிக்கைகளாக மாற்றப்படுவதில்லை.
அணுகல் மற்றும் பிழைகள்#
பயன்படுத்தவும் inference அங்கீகரிக்கப்பட்ட நெட்வொர்க்-செலவு inference க்காக அல்லது monetization_gateway அங்கீகரிக்கப்பட்ட Builder மார்க்அப் மற்றும் ஏற்றுக்கொள்ளப்பட்ட கட்டண விதிமுறைகளுக்காக. அடையாளம் மட்டும் அணுகல் செலவுகளை அங்கீகரிக்காது. சரிபார்ப்பு, மாடல் அங்கீகாரம், போதுமான கிரெடிட்கள், விகித வரம்புகள் மற்றும் செயல்பாட்டு தோல்விகள் ஒரு கட்டமைக்கப்பட்ட error. Timeout அல்லது உறுதிப்படுத்தப்படாத சமர்ப்பிப்பு பிறகு, Usage அல்லது வீடியோ வேலைகளை ஆய்வு செய்து, மற்றொரு செலவான கோரிக்கையை உருவாக்குவதற்கு முன்.
கடைசியாக புதுப்பிக்கப்பட்டது நவம்பர் 3, 2026