OpenAI: DALL·E 3
DALL·E 3 menjana imej daripada taklimat adegan bertulis. Gunakan ID model tepat openai/dall-e-3 atau alias dall-e-3 dengan kaedah penjanaan imej, kemudian simpan setiap URL imej yang dikembalikan dan hasil yang mengiringinya. Permintaan permulaan yang didokumenkan menghasilkan satu imej 1024x1024 daripada teks.
- Ailoot Ultra · Images
POST /v1/images/generationsopenai/dall-e-3 - Ailoot Ultra · Images
POST /v1/images/generationsdall-e-3
Tentang model
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
DALL·E 3 ialah model teks-ke-imej OpenAI. Gunakan taklimat bertulis untuk mencipta ilustrasi, konsep adegan atau arah visual bagi reka bentuk. Terangkan subjek, persekitaran, komposisi, pencahayaan dan olahan dalam prompt. Sebagai contoh, taklimat konsep boleh meminta basikal penghantaran di sebelah kedai kecil pada waktu senja, dilihat dari jalan, dengan subjek latar depan yang jelas dan palet warna yang sederhana.
Hantar POST /v1/images/generations dengan badan application/json. ID model awam yang tepat ialah openai/dall-e-3; alias yang dibenarkan dall-e-3 memilih kad model yang sama. Bentuk permulaan yang didokumenkan membekalkan model, prompt, n:1 dan size:"1024x1024". n ialah integer pilihan dan mempunyai nilai lalai 1. Hantar stream:false, atau jangan sertakan stream, untuk hasil JSON lengkap. Gunakan prompt teks yang tidak kosong dan fokuskan permintaan ini pada satu taklimat imej lengkap. Kaedah yang ditawarkan ialah penjanaan imej daripada teks.
Nyatakan secara jelas keperluan yang penting untuk penempatan. Ilustrasi editorial boleh menamakan idea utama dan objek yang menyatakannya. Konsep adegan boleh menentukan kedudukan kamera, waktu dalam sehari dan bahagian komposisi yang memerlukan ruang di sekelilingnya. Asingkan kata-kata tepat yang mesti muncul dalam imej daripada penerangan adegan, kemudian periksa tulisan yang dipaparkan dan susunan visual sebelum menggunakan hasil terpilih.
Balasan penjanaan ialah JSON dengan cap masa created dan tatasusunan data. Item hasil yang didokumenkan merangkumi url dan mungkin merangkumi revised_prompt, prompt_filter_results dan content_filter_results. Simpan medan itu bersama balasan lengkap, dan muat turun imej pada setiap URL Ailoot bertandatangan yang dikembalikan. Pautan fail Ailoot bertandatangan sah selama 24 jam dari masa dikeluarkan. Simpan URL tepat yang dikembalikan, termasuk rentetan pertanyaannya, sehingga fail disimpan; tentukan format imej yang disimpan daripada balasan sebenar atau bait fail.
Anggap fail imej yang dikembalikan sebagai aset reka bentuk yang boleh digunakan dan JSON sebagai rekod penjanaan yang mengiringinya. Semak imej berdasarkan taklimat yang dibekalkan sebelum meletakkannya dalam halaman, persembahan atau aplikasi. Jika balasan tidak lengkap atau hasil penghantaran tidak pasti, simpan pengecam permintaan asal dan maklumat yang dikembalikan semasa menyemak percubaan sedia ada, dan bukannya mencipta imej lain semata-mata untuk mendapatkan semula hasil yang hilang. Untuk mendapatkan hasil yang disimpan, gunakan kunci API yang sama untuk GET /v1/media/assets?family=image dan ikuti setiap next_cursor. ID aset muncul dalam setiap URL /v1/media/assets/{asset_id}/content yang dikembalikan dan dalam rekod pustaka medianya. Baca GET /v1/media/assets/{asset_id} bagi setiap rekod yang dipilih dan muat turun content_url tepatnya. Jika permintaan fail mengembalikan 404 dengan kod link_expired, baca semula aset yang sama untuk mendapatkan pautan yang diperbaharui. Memperbaharui pautan aset tidak memerlukan permintaan penjanaan imej lain.
Ailoot Ultra · Images POST /v1/images/generations openai/dall-e-3
openai/dall-e-3openai/dall-e-3dall-e-3
Pengenalan
DALL·E 3 menjana imej daripada taklimat adegan bertulis. Gunakan ID model tepat openai/dall-e-3 atau alias dall-e-3 dengan kaedah penjanaan imej, kemudian simpan setiap URL imej yang dikembalikan dan hasil yang mengiringinya. Permintaan permulaan yang didokumenkan menghasilkan satu imej 1024x1024 daripada teks.
- Input yang diterima
- Teks
- Hasil
- Imej
Tersedia di Ailoot · input & kaedah
Ailoot Ultra · Images POST /v1/images/generations
- Input
text- Output
image- Format output
- Fail imej
| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had openai/dall-e-3 | Lalai— |
Medanprompt | Jenisstring | KeperluanDiperlukan | Nilai & had | Lalai— |
Medanstream | Jenisboolean | KeperluanPilihan | Nilai & had false | Lalaifalse |
Medann | Jenisinteger | KeperluanPilihan | Nilai & had 1 | Lalai— |
Medansize | Jenisstring | KeperluanPilihan | Nilai & had 1024x1024 | Lalai— |
Parameter kaedah dan kitar hayat
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, prompt |
Parameteroptional | Kontrakstream, n, size |
Parametermaterial_types | Kontraktext |
Parameterconditions | KontrakUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Kitar hayat: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Pelan harga
Cara caj akhir dikira
Kadar yang dipaparkan menganggarkan kos sebelum penjanaan. Caj akhir dikira berdasarkan kos yang direkodkan untuk penjanaan asal. Tempoh output yang diukur dan kuantiti ramalan bukan kuantiti akhir yang boleh dibilkan.
Rujukan tarif tidak menambah pilihan permintaan. Parameter yang disokong disenaraikan untuk kaedah yang dipilih.
- Mod pantas
- Tidak dinyatakan Apabila mod pantas dipilih
- Mod flex
- Tidak dinyatakan Apabila mod flex dipilih
- Usaha penaakulan maksimum
- Tidak dinyatakan Apabila usaha penaakulan maksimum menggunakan pelarasan default
Anggaran kadar untuk perbandingan
Harga mengikut konfigurasi
Padankan setiap caj dengan syarat yang dipaparkan. Gunakan satu kadar bagi setiap set konfigurasi alternatif.
| Konfigurasi | Jadual kadar | Kuantiti ramalan | Caj |
|---|---|---|---|
| KonfigurasiKadar asas token | Jadual kadarKadar asas | Kuantiti ramalan— | Caj Input · Token input · Anggaran untuk perbandingan sahaja — / 1K token Output · Token output · Anggaran untuk perbandingan sahaja — / 1K token Input · Bacaan cache · Anggaran untuk perbandingan sahaja — / 1K token Input · Penulisan cache · Anggaran untuk perbandingan sahaja — / 1K token Input · Penulisan cache, 1 jam · Anggaran untuk perbandingan sahaja — / 1K token |
| KonfigurasiEstimated generation cost | Jadual kadar— | Kuantiti ramalananggaran untuk satu penjanaan | Caj Input · Anggaran kos penjanaan · Anggaran untuk perbandingan sahaja $0.32768 anggaran sebelum penjanaan This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot merizabkan anggaran amaun sebelum permintaan. Selepas hasil diterima, caj akhir diselesaikan berdasarkan penggunaan terukur. Penyelesaian caj penstriman menggunakan rekod penggunaan akhir. Cara rizab dan penyelesaian caj berfungsi →
Contoh permintaan
Ailoot Ultra · Images
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "openai/dall-e-3", "prompt": "A calm studio product photograph with a plain background.", "n": 1, "size": "1024x1024"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
Terima dan simpan hasil
Ailoot Ultra · Images
Muat turun setiap imej yang dikembalikan atau simpan kandungan Base64-nya
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Simpan semua hasil yang selesai
Simpan setiap imej yang selesai; dapatkan setiap URL yang dikembalikan atau nyahkod kandungan Base64-nya.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
Jika respons asal perlu disemak
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Alias
Alias model
Ailoot Ultra openai/dall-e-3, dall-e-3
Alias laluan kaedah
Gunakan laluan kaedah yang dipaparkan di atas.
ID pemanggil berkaitan
Ailoot Ultra · Images POST /v1/images/generations dall-e-3
dall-e-3openai/dall-e-3dall-e-3
Pengenalan
DALL·E 3 menjana imej daripada taklimat adegan bertulis. Gunakan ID model tepat openai/dall-e-3 atau alias dall-e-3 dengan kaedah penjanaan imej, kemudian simpan setiap URL imej yang dikembalikan dan hasil yang mengiringinya. Permintaan permulaan yang didokumenkan menghasilkan satu imej 1024x1024 daripada teks.
- Input yang diterima
- Teks
- Hasil
- Imej
Tersedia di Ailoot · input & kaedah
Ailoot Ultra · Images POST /v1/images/generations
- Input
text- Output
image- Format output
- Fail imej
| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had dall-e-3 | Lalai— |
Medanprompt | Jenisstring | KeperluanDiperlukan | Nilai & had | Lalai— |
Medanstream | Jenisboolean | KeperluanPilihan | Nilai & had false | Lalaifalse |
Medann | Jenisinteger | KeperluanPilihan | Nilai & had 1 | Lalai— |
Medansize | Jenisstring | KeperluanPilihan | Nilai & had 1024x1024 | Lalai— |
Parameter kaedah dan kitar hayat
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, prompt |
Parameteroptional | Kontrakstream, n, size |
Parametermaterial_types | Kontraktext |
Parameterconditions | KontrakUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Kitar hayat: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Pelan harga
Cara caj akhir dikira
Kadar yang dipaparkan menganggarkan kos sebelum penjanaan. Caj akhir dikira berdasarkan kos yang direkodkan untuk penjanaan asal. Tempoh output yang diukur dan kuantiti ramalan bukan kuantiti akhir yang boleh dibilkan.
Rujukan tarif tidak menambah pilihan permintaan. Parameter yang disokong disenaraikan untuk kaedah yang dipilih.
- Mod pantas
- Tidak dinyatakan Apabila mod pantas dipilih
- Mod flex
- Tidak dinyatakan Apabila mod flex dipilih
- Usaha penaakulan maksimum
- Tidak dinyatakan Apabila usaha penaakulan maksimum menggunakan pelarasan default
Anggaran kadar untuk perbandingan
Harga mengikut konfigurasi
Padankan setiap caj dengan syarat yang dipaparkan. Gunakan satu kadar bagi setiap set konfigurasi alternatif.
| Konfigurasi | Jadual kadar | Kuantiti ramalan | Caj |
|---|---|---|---|
| KonfigurasiKadar asas token | Jadual kadarKadar asas | Kuantiti ramalan— | Caj Input · Token input · Anggaran untuk perbandingan sahaja — / 1K token Output · Token output · Anggaran untuk perbandingan sahaja — / 1K token Input · Bacaan cache · Anggaran untuk perbandingan sahaja — / 1K token Input · Penulisan cache · Anggaran untuk perbandingan sahaja — / 1K token Input · Penulisan cache, 1 jam · Anggaran untuk perbandingan sahaja — / 1K token |
| KonfigurasiEstimated generation cost | Jadual kadar— | Kuantiti ramalananggaran untuk satu penjanaan | Caj Input · Anggaran kos penjanaan · Anggaran untuk perbandingan sahaja $0.32768 anggaran sebelum penjanaan This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot merizabkan anggaran amaun sebelum permintaan. Selepas hasil diterima, caj akhir diselesaikan berdasarkan penggunaan terukur. Penyelesaian caj penstriman menggunakan rekod penggunaan akhir. Cara rizab dan penyelesaian caj berfungsi →
Contoh permintaan
Ailoot Ultra · Images
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "dall-e-3", "prompt": "A calm studio product photograph with a plain background.", "n": 1, "size": "1024x1024"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
# Submit once. Retain the complete result, original identifiers and every response header.
Terima dan simpan hasil
Ailoot Ultra · Images
Muat turun setiap imej yang dikembalikan atau simpan kandungan Base64-nya
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Simpan semua hasil yang selesai
Simpan setiap imej yang selesai; dapatkan setiap URL yang dikembalikan atau nyahkod kandungan Base64-nya.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
Jika respons asal perlu disemak
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Alias
Alias model
Ailoot Ultra openai/dall-e-3, dall-e-3
Alias laluan kaedah
Gunakan laluan kaedah yang dipaparkan di atas.
ID pemanggil berkaitan
FAQ · OpenAI: DALL·E 3
- Apakah input dan hasil yang tersedia?
POST /v1/images/generations·openai/dall-e-3:text→imagePOST /v1/images/generations·dall-e-3:text→image- Apakah medan yang digunakan oleh permintaan?
POST /v1/images/generations·openai/dall-e-3:model,prompt,stream,n,sizePOST /v1/images/generations·dall-e-3:model,prompt,stream,n,size