Menghasilkan gambar
Respons JSON sinkron berisi hasil gambar dalam data.
Di halaman ini
https://api.shareai.now/api/v1/imagesMenghasilkan gambar
- URL Dasar
https://api.shareai.now- Otentikasi
- Kunci API Bearer atau token akses OAuth yang disetujui
- Cakupan yang diperlukan
inferenceormonetization_gateway
Respons JSON sinkron berisi hasil gambar dalam data. Alias /api/v1/images/generations juga didukung. Opsi seperti ukuran, resolusi, aspect_ratio, kualitas, dan format keluaran bergantung pada model yang dipilih. Respons dibatasi hingga 2 MiB; kurangi jumlah atau ukuran gambar jika diperlukan. Gambar yang dikembalikan dibatasi hingga 8192 piksel per sisi.
Sebelum Anda memulai#
Atur SHAREAI_API_KEY di server Anda dan ganti placeholder model dengan model yang saat ini diaktifkan. Jangan pernah mengekspos kunci API dalam kode browser. Model, akun, kredensial, dan penyedia semuanya harus mengizinkan operasi ini. Pengaturan opsional di bawah ini memerlukan dukungan model; batas keamanan API bukanlah janji bahwa setiap model mendukung setiap nilai.
Kirim permintaan#
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);Bidang permintaan#
| Bidang | Tipe | Makna dan batasan |
|---|---|---|
model diperlukan | string | Pengidentifikasi model publik yang diaktifkan secara tepat. Harus mendeklarasikan operasi ini dan diizinkan oleh kredensial Anda. |
prompt diperlukan | string | Prompt generasi tidak kosong, maksimal 256 KiB teks UTF-8. |
n | bilangan bulat | Jumlah gambar opsional, 1–10; default 1. Model Anda mungkin mengizinkan lebih sedikit. |
size | string | Ukuran keluaran yang didukung model, maksimal 100 karakter, misalnya 1024×1024. Tidak semua model mendukung opsi ini. |
resolution | string | Pemilih resolusi yang didukung model, maksimal 100 karakter; harus sesuai dengan varian tarif yang dipublikasikan. |
aspect_ratio | string | Pemilih rasio aspek yang didukung model, maksimal 100 karakter. |
quality | string | Pemilih kualitas yang didukung model, maksimal 100 karakter; dapat memilih tarif yang berbeda. |
response_format | string | Format respons yang didukung model, maksimal 100 karakter. Operasi menentukan apakah hasilnya berupa JSON atau biner. |
output_format | string | Pemilih pengkodean keluaran yang didukung model, maksimal 100 karakter. |
background | string | Pengaturan latar belakang gambar opsional jika didukung oleh model. |
seed | bilangan bulat | Seed opsional yang didukung model. Video memerlukan bilangan bulat non-negatif; reprodusibilitas bergantung pada eksekutor. |
input_references | array | Maksimal 16 bagian image_url yang diketik dengan image_url.url diatur ke URL HTTPS atau URL data gambar yang didukung. Dukungan model diperlukan. |
provider | objek | Preferensi routing penyedia opsional. Gunakan provider.only untuk tag penyedia yang diterima, bukan awalan dalam ID model. Pembatasan akun dan kredensial tetap berlaku. |
Baca hasilnya#
Keberhasilan mengembalikan HTTP 200 dengan JSON. Respons JSON sinkron berisi hasil gambar dalam data. Alias /api/v1/images/generations juga didukung. Opsi seperti ukuran, resolusi, aspect_ratio, kualitas, dan format keluaran bergantung pada model yang dipilih. Respons dibatasi hingga 2 MiB; kurangi jumlah atau ukuran gambar jika diperlukan. Gambar yang dikembalikan dibatasi hingga 8192 piksel per sisi.
Unit penagihan#
Tarif gambar dapat menggunakan gambar yang dihasilkan, megapiksel yang diukur, referensi input, permintaan, atau token yang dilaporkan oleh penyedia. URL gambar bukanlah ukuran ukuran gambar. Tarif megapiksel memerlukan dimensi gambar yang dikembalikan; gunakan keluaran base64 untuk rute tersebut.
Pilih pengidentifikasi model yang diaktifkan secara tepat dari Console. Operasi yang dideklarasikan dan kemampuan input/output-nya harus sesuai dengan endpoint ini; model chat teks tidak dapat diganti untuk operasi lain. Pembatasan kredensial, penyedia, dan akun Anda tetap berlaku.
Harga dan penggunaan#
Tarif diterbitkan dalam kredit AI EUR untuk model, penyedia, unit, dan varian yang dipilih. Hanya dimensi dalam tarif aktifnya yang dikenakan biaya. Perkiraan akan memesan kredit sebelum eksekusi; biaya akhir menggunakan penggunaan yang terukur. Harga dapat bergantung pada resolusi, format output, atau rentang penggunaan. Periksa Penggunaan di Console untuk debit ShareAI akhir. Bidang biaya hulu dan byte media tidak diubah menjadi jumlah token yang diciptakan.
Akses dan kesalahan#
Gunakan inference untuk inferensi biaya jaringan yang disetujui atau monetization_gateway untuk markup Builder yang disetujui dan ketentuan penagihan yang diterima. Akses hanya identitas tidak mengizinkan pengeluaran. Validasi, otorisasi model, kredit yang tidak mencukupi, batasan tarif, dan kegagalan eksekusi mengembalikan struktur error. Setelah batas waktu atau pengiriman yang tidak pasti, periksa Penggunaan atau pekerjaan video sebelum membuat permintaan lain yang mungkin berbayar.
Terakhir diperbarui 3 November 2026