OpenAI: DALL·E 3
DALL·E 3 жазбаша көрініс тапсырмасынан кескін жасайды. Кескін генерациялау әдісінде дәл openai/dall-e-3 модель ID мәнін немесе оның dall-e-3 балама атауын пайдаланып, кейін қайтарылған әр кескін URL мекенжайын және бірге берілген нәтижені сақтаңыз. Құжатталған бастапқы сұрау мәтіннен бір 1024x1024 кескін жасайды.
- Ailoot Ultra · Images
POST /v1/images/generationsopenai/dall-e-3 - Ailoot Ultra · Images
POST /v1/images/generationsdall-e-3
Модель туралы
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
DALL·E 3 — OpenAI компаниясының мәтіннен кескін жасау моделі. Иллюстрация, көрініс тұжырымдамасы немесе дизайнға арналған көрнекі бағыт жасау үшін жазбаша тапсырма пайдаланыңыз. Промптта нысанды, ортаны, композицияны, жарықты және көркемдік тәсілді сипаттаңыз. Мысалы, тұжырымдамалық тапсырма іңірде шағын дүкеннің жанындағы жеткізу велосипедін, көшеден қараған көріністі, алдыңғы көріністегі айқын нысанды және ұстамды түс палитрасын сұрай алады.
application/json денесімен POST /v1/images/generations сұрауын жіберіңіз. Дәл ашық модель ID мәні — openai/dall-e-3; рұқсат етілген dall-e-3 балама атауы сол модель карточкасын таңдайды. Құжатталған бастапқы пішім model, prompt, n:1 және size:"1024x1024" береді. n — қосымша бүтін сан, әдепкі мәні — 1. Толық JSON нәтижесі үшін stream:false жіберіңіз немесе stream қоспаңыз. Бос емес мәтіндік промпт пайдаланып, бұл сұрауды бір толық кескін тапсырмасына бағыттаңыз. Ұсынылатын әдіс — мәтіннен кескін генерациялау.
Орналастыру үшін маңызды талаптарды нақты көрсетіңіз. Редакциялық иллюстрация негізгі ойды және оны білдіретін заттарды атай алады. Көрініс тұжырымдамасы камера орнын, тәулік уақытын және композицияның қай бөліктеріне айналасында бос орын керек екенін көрсете алады. Кескінде көрінуі тиіс дәл сөздерді көрініс сипаттамаларынан бөлек ұстаңыз, кейін таңдалған нәтижені қолданбас бұрын бейнеленген жазуды және көрнекі орналасуды тексеріңіз.
Генерация жауабы — created уақыт белгісі және data массиві бар JSON. Құжатталған нәтиже элементінде url бар және revised_prompt, prompt_filter_results пен content_filter_results болуы мүмкін. Осы өрістерді толық жауаппен бірге сақтап, қайтарылған әр қолтаңбаланған Ailoot URL мекенжайындағы кескінді жүктеп алыңыз. Ailoot қолтаңбаланған файл сілтемелері берілген кезден бастап 24 сағат жарамды. Файл сақталғанша қайтарылған URL мекенжайын сұрау жолымен бірге дәл сақтаңыз; сақталған кескін пішімін нақты жауаптан немесе файл байттарынан анықтаңыз.
Қайтарылған кескін файлын қолдануға болатын дизайн активі, ал JSON деректерін оған ілесетін генерация жазбасы ретінде қарастырыңыз. Кескінді бетке, презентацияға немесе қолданбаға орналастырмас бұрын берілген тапсырмамен салыстырып тексеріңіз. Жауап толық болмаса немесе жіберу нәтижесі белгісіз болса, жетіспейтін нәтижені алу үшін ғана тағы бір кескін жасаудың орнына бар әрекетті тексергенде бастапқы сұрау сәйкестендіргішін және қайтарылған ақпаратты сақтаңыз. Сақталған нәтижелерді алу үшін сол API кілтімен GET /v1/media/assets?family=image сұрауын пайдаланып, әр next_cursor бойымен өтіңіз. Актив ID мәні әр қайтарылған /v1/media/assets/{asset_id}/content URL мекенжайында және оның медиа кітапхана жазбасында көрінеді. Таңдалған әр жазба үшін GET /v1/media/assets/{asset_id} сұрауын оқып, дәл content_url мекенжайын жүктеп алыңыз. Файл сұрауы link_expired коды бар 404 қайтарса, жаңартылған сілтеме алу үшін сол активті қайта оқыңыз. Актив сілтемесін жаңарту тағы бір кескін генерациялау сұрауын талап етпейді.
Ailoot Ultra · Images POST /v1/images/generations openai/dall-e-3
openai/dall-e-3openai/dall-e-3dall-e-3
Бастау
DALL·E 3 жазбаша көрініс тапсырмасынан кескін жасайды. Кескін генерациялау әдісінде дәл openai/dall-e-3 модель ID мәнін немесе оның dall-e-3 балама атауын пайдаланып, кейін қайтарылған әр кескін URL мекенжайын және бірге берілген нәтижені сақтаңыз. Құжатталған бастапқы сұрау мәтіннен бір 1024x1024 кескін жасайды.
- Қабылданатын кіріс деректері
- Мәтін
- Нәтижелер
- Суреттер
Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер
Ailoot Ultra · Images POST /v1/images/generations
- Кіріс
text- Шығыс
image- Шығыс пішімі
- Сурет файлы
| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер openai/dall-e-3 | Әдепкі— |
Өрісprompt | Түріstring | ТалапМіндетті | Мәндер мен шектеулер | Әдепкі— |
Өрісstream | Түріboolean | ТалапМіндетті емес | Мәндер мен шектеулер false | Әдепкіfalse |
Өрісn | Түріinteger | ТалапМіндетті емес | Мәндер мен шектеулер 1 | Әдепкі— |
Өрісsize | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер 1024x1024 | Әдепкі— |
Әдіс параметрлері мен өмірлік циклі
| Параметр | Параметр талаптары |
|---|---|
Параметрcontent_type | Параметр талаптарыapplication/json |
Параметрrequired | Параметр талаптарыmodel, prompt |
Параметрoptional | Параметр талаптарыstream, n, size |
Параметрmaterial_types | Параметр талаптарыtext |
Параметрconditions | Параметр талаптарыUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Өмірлік цикл: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Тарифтер
Қорытынды төлем қалай есептеледі
Көрсетілген тарифтер генерация басталғанға дейінгі құнын бағалауға арналған. Соңғы төлем бастапқы генерация үшін тіркелген құннан есептеледі. Нәтиженің өлшенген ұзақтығы мен болжамды көлемдер төлемге негіз болатын түпкілікті көлем болып саналмайды.
Тариф анықтамасы сұрау мүмкіндіктерін қоспайды. Қолдау көрсетілетін параметрлер таңдалған әдісте берілген.
- Жылдам режим
- Көрсетілмеген Жылдам режим таңдалғанда
- Икемді режим
- Көрсетілмеген flex режимі таңдалғанда
- Ой қорытудың ең жоғары деңгейі
- Көрсетілмеген Ой қорыту деңгейі ең жоғары болып, default түзетуі қолданылғанда
Салыстыруға арналған болжамды мөлшерлемелер
Баптаулар бойынша бағалар
Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.
| Баптау | Мөлшерлемелер кестесі | Болжамды мөлшер | Төлем |
|---|---|---|---|
| БаптауТокендердің базалық тарифтері | Мөлшерлемелер кестесіНегізгі мөлшерлеме | Болжамды мөлшер— | Төлем Кіріс · Кіріс токендері · Тек салыстыруға арналған бағалау — / 1K токен Шығыс · Шығыс токендері · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшті оқу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу, 1 сағ · Тек салыстыруға арналған бағалау — / 1K токен |
| БаптауEstimated generation cost | Мөлшерлемелер кестесі— | Болжамды мөлшербір генерацияға арналған болжам | Төлем Кіріс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $0.32768 жасауға дейінгі бағалау This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
Сұрау мысалдары
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.
Нәтижелерді алу және сақтау
Ailoot Ultra · Images
Қайтарылған әр суретті жүктеп алыңыз немесе оның Base64 мазмұнын сақтаңыз
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Барлық дайын нәтижені сақтау
Әр дайын суретті сақтаңыз; қайтарылған әр URL арқылы мазмұнды алыңыз немесе оның Base64 мазмұнын декодтаңыз.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
Бастапқы жауапты тексеру қажет болса
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Балама атаулар
Модельдердің балама атаулары
Ailoot Ultra openai/dall-e-3, dall-e-3
Әдіс жолдарының балама атаулары
Жоғарыда көрсетілген әдіс жолдарын пайдаланыңыз.
Шақыруға арналған байланысты ID
Ailoot Ultra · Images POST /v1/images/generations dall-e-3
dall-e-3openai/dall-e-3dall-e-3
Бастау
DALL·E 3 жазбаша көрініс тапсырмасынан кескін жасайды. Кескін генерациялау әдісінде дәл openai/dall-e-3 модель ID мәнін немесе оның dall-e-3 балама атауын пайдаланып, кейін қайтарылған әр кескін URL мекенжайын және бірге берілген нәтижені сақтаңыз. Құжатталған бастапқы сұрау мәтіннен бір 1024x1024 кескін жасайды.
- Қабылданатын кіріс деректері
- Мәтін
- Нәтижелер
- Суреттер
Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер
Ailoot Ultra · Images POST /v1/images/generations
- Кіріс
text- Шығыс
image- Шығыс пішімі
- Сурет файлы
| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер dall-e-3 | Әдепкі— |
Өрісprompt | Түріstring | ТалапМіндетті | Мәндер мен шектеулер | Әдепкі— |
Өрісstream | Түріboolean | ТалапМіндетті емес | Мәндер мен шектеулер false | Әдепкіfalse |
Өрісn | Түріinteger | ТалапМіндетті емес | Мәндер мен шектеулер 1 | Әдепкі— |
Өрісsize | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер 1024x1024 | Әдепкі— |
Әдіс параметрлері мен өмірлік циклі
| Параметр | Параметр талаптары |
|---|---|
Параметрcontent_type | Параметр талаптарыapplication/json |
Параметрrequired | Параметр талаптарыmodel, prompt |
Параметрoptional | Параметр талаптарыstream, n, size |
Параметрmaterial_types | Параметр талаптарыtext |
Параметрconditions | Параметр талаптарыUse stream:false or omit stream. The complete buffered JSON result contains all generated images. |
Өмірлік цикл: synchronous_result_then_owned_library
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Тарифтер
Қорытынды төлем қалай есептеледі
Көрсетілген тарифтер генерация басталғанға дейінгі құнын бағалауға арналған. Соңғы төлем бастапқы генерация үшін тіркелген құннан есептеледі. Нәтиженің өлшенген ұзақтығы мен болжамды көлемдер төлемге негіз болатын түпкілікті көлем болып саналмайды.
Тариф анықтамасы сұрау мүмкіндіктерін қоспайды. Қолдау көрсетілетін параметрлер таңдалған әдісте берілген.
- Жылдам режим
- Көрсетілмеген Жылдам режим таңдалғанда
- Икемді режим
- Көрсетілмеген flex режимі таңдалғанда
- Ой қорытудың ең жоғары деңгейі
- Көрсетілмеген Ой қорыту деңгейі ең жоғары болып, default түзетуі қолданылғанда
Салыстыруға арналған болжамды мөлшерлемелер
Баптаулар бойынша бағалар
Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.
| Баптау | Мөлшерлемелер кестесі | Болжамды мөлшер | Төлем |
|---|---|---|---|
| БаптауТокендердің базалық тарифтері | Мөлшерлемелер кестесіНегізгі мөлшерлеме | Болжамды мөлшер— | Төлем Кіріс · Кіріс токендері · Тек салыстыруға арналған бағалау — / 1K токен Шығыс · Шығыс токендері · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшті оқу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу, 1 сағ · Тек салыстыруға арналған бағалау — / 1K токен |
| БаптауEstimated generation cost | Мөлшерлемелер кестесі— | Болжамды мөлшербір генерацияға арналған болжам | Төлем Кіріс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $0.32768 жасауға дейінгі бағалау This estimate is not an additional charge or a fixed rate for the completed generation. |
Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
Сұрау мысалдары
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.
Нәтижелерді алу және сақтау
Ailoot Ultra · Images
Қайтарылған әр суретті жүктеп алыңыз немесе оның Base64 мазмұнын сақтаңыз
GET /v1/media/assetsGET /v1/media/assets/{asset_id}
Барлық дайын нәтижені сақтау
Әр дайын суретті сақтаңыз; қайтарылған әр URL арқылы мазмұнды алыңыз немесе оның Base64 мазмұнын декодтаңыз.
Retain every returned image and field. Use owned content_url values and actual asset_id records; refresh the same asset when a link expires.
Бастапқы жауапты тексеру қажет болса
Preserve the original response, headers and X-Client-Request-ID. An uncertain outcome does not authorize another creation.
Балама атаулар
Модельдердің балама атаулары
Ailoot Ultra openai/dall-e-3, dall-e-3
Әдіс жолдарының балама атаулары
Жоғарыда көрсетілген әдіс жолдарын пайдаланыңыз.
Шақыруға арналған байланысты ID
FAQ · OpenAI: DALL·E 3
- Қандай кіріс деректері мен нәтижелер қолжетімді?
POST /v1/images/generations·openai/dall-e-3:text→imagePOST /v1/images/generations·dall-e-3:text→image- Сұрау қандай өрістерді пайдаланады?
POST /v1/images/generations·openai/dall-e-3:model,prompt,stream,n,sizePOST /v1/images/generations·dall-e-3:model,prompt,stream,n,size