Hasilkan gambar

Gunakan model gambar yang saat ini diaktifkan di ShareAI dan diizinkan oleh kredensial Anda. Model menentukan ukuran, tingkat kualitas, dan opsi output yang didukung.

Kirim permintaan#

curl --fail-with-body --request POST \
  "https://api.shareai.now/api/v1/images/generations" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_IMAGE_MODEL",
  "prompt": "A quiet forest painted in watercolor.",
  "n": 1,
  "size": "1024x1024"
}'

import json
import os
import urllib.request

headers = {"Authorization": "Bearer " + os.environ["SHAREAI_API_KEY"]}
headers["Content-Type"] = "application/json"
payload = {'model': 'YOUR_IMAGE_MODEL', 'prompt': 'A quiet forest painted in watercolor.', 'n': 1, 'size': '1024x1024'}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/images/generations', data=data, headers=headers, method='POST')
with urllib.request.urlopen(request, timeout=180) as response:
    print(json.load(response))

const url = "https://api.shareai.now/api/v1/images/generations";
const headers: Record = {
  Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
  "model": "YOUR_IMAGE_MODEL",
  "prompt": "A quiet forest painted in watercolor.",
  "n": 1,
  "size": "1024x1024"
};
const response = await fetch(url, { method: "POST", headers, body: JSON.stringify(payload) });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());

Bidang permintaan#

Baca gambar#

Periksa data entri yang dikembalikan. Bergantung pada model dan format yang diminta, sebuah entri berisi URL gambar HTTPS atau data gambar base64. Gunakan format yang benar-benar dikembalikan; jangan berasumsi setiap penyedia mengembalikan URL. API tidak mengunduh URL gambar yang dikembalikan untuk Anda.

Batas ukuran dan waktu#

Permintaan bersifat sinkron. Teks gabungan dibatasi hingga 256 KiB, panggilan penyedia hingga 120 detik, dan respons hingga 2 MiB. Gambar base64 besar dapat melebihi batas respons tersebut. Pilih ukuran output yang sesuai atau model yang mendukung output URL.

Coba ulang dengan hati-hati#

Membuat gambar dapat menimbulkan penggunaan. Setelah waktu habis atau kegagalan jaringan yang ambigu, periksa aktivitas sebelum mencoba ulang; mengulangi permintaan dapat menghasilkan dan membebankan biaya untuk gambar lain. API tidak secara otomatis mencoba ulang permintaan gambar setelah dikirimkan ke penyedia.

Operasi yang didukung#

Rute ini menghasilkan gambar dari teks. Pengeditan gambar, variasi, unggahan multipart, dan pembuatan gambar streaming tidak didukung. Penagihan saat ini memerlukan kontrak penggunaan token model/penyedia yang kompatibel; penyedia hanya per gambar mungkin tidak tersedia.

Gunakan otorisasi pelanggan#

Untuk alur OAuth yang disetujui, kirim token akses sebagai Bearer. Pembuatan gambar yang didanai akun memerlukan surcharge dan rencana penggunaan yang diterima. Semua pembatasan model, penyedia, dan akun tetap berlaku.