Запросы изображений
Используйте ответы изображения с предсказуемым запросом API.
Проверьте обработку запросов изображений через OpenAI-совместимую конечную точку изображений с возвращаемыми URL-адресами или полезными нагрузками b64_json, сохраняя при этом запросы в безопасности, учетные данные на стороне сервера и использование изображений видимыми.
Последнее обновление: July 12, 2026. Examples использование safe placeholders и сделать не включить real API ключs, секреты, customer полезные нагрузки, или чувствительный промпты.
Путь по умолчанию
Начните с одного изображения стандартного квадратного размера и формата ответа URL. Добавляйте большие размеры или base64 только тогда, когда они нужны рабочему процессу.
Путь установки
Четыре шага от запроса до формы возвращенного актива.
Step 1
Аутентификация на стороне сервера
Используйте ключ API с областью images:write из доверенного серверного кода.
Открыть разделStep 2
Отправить запрос
Отправьте безопасное приглашение, количество изображений, размер и формат ответа в конечную точку изображений.
Открыть разделStep 3
Чтение возвращенных активов
Используйте возвращаемые URL-адреса или полезные данные b64_json в соответствии с форматом ответа, запрошенным вашим приложением.
Открыть разделStep 4
Следите за использованием изображений
Запросы изображений записывают объем запроса, токены подсказок и возвращаемые элементы изображений для журналов и проверки ограничения скорости.
Открыть разделКонечная точка
Отправьте запросы в конечную точку изображений.
Используйте маршрут изображений /v1 с серверным ключом с ограниченной областью действия, прежде чем рабочие процессы изображений дойдут до клиентов. Обеспечьте безопасность содержимого подсказок и избегайте размещения конфиденциальных данных в запросах изображений.
| Товар | Значение | Примечания |
|---|---|---|
| Метод | POST | Отправьте JSON в конечную точку изображений. |
| Конечная точка | https://unlimitedcodex.com/v1/images/generations | Используйте путь к изображениям /v1, совместимый с OpenAI. |
| Авторизация | Токен на предъявителя | Используйте ключ API с ограниченной областью действия с доступом images:write. |
| Тип контента | приложение/json | Тело запроса должно быть действительным JSON. |
Запросить форму
Пусть первый запрос будет небольшим.
Начните с вывода одного изображения и URL-адреса при проверке потока. Увеличивайте количество, размер или встроенный код base64 только после того, как ваш пользовательский интерфейс и обработка скорости будут готовы.
| Поле | Статус | Примечания |
|---|---|---|
| модель | Рекомендуется | Явно передайте значение модели изображения. Используйте значение модели из предоставленных вами сведений о настройке. |
| подсказать | Требуется | Отправьте непустое приглашение длиной до 4000 символов. Избегайте секретов, регулируемых данных и деталей, позволяющих идентифицировать клиента. |
| n | Необязательно | Запросите от 1 до 4 изображений. Значение по умолчанию — 1. |
| размер | Необязательно | Используйте 256x256, 512x512, 1024x1024, 1024x1792 или 1792x1024. По умолчанию — 1024x1024. |
| ответ_формат | Необязательно | Используйте URL-адрес для извлекаемой ссылки на актив или b64_json для встроенных данных в формате Base64. |
const response = await fetch("https://unlimitedcodex.com/v1/images/generations", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.UCX_API_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
model: "ucx-image-1",
prompt: "A clean product illustration of an API usage dashboard.",
n: 1,
size: "1024x1024",
response_format: "url"
})
});
const body = await response.json();
if (!response.ok) {
throw new Error(body.error?.code ?? "image_request_failed");
}
const firstImageUrl = body.data[0].url;Форма ответа
Прочтите формат ресурса, запрошенный вашим приложением.
Ответ включает метаданные запроса и один элемент данных для каждого возвращаемого изображения. Используйте URL-адрес или b64_json на основе response_format.
| Поле | Значение | Примечания |
|---|---|---|
| идентификатор | идентификатор запроса изображения | Используйте для журналов и эскалации поддержки. |
| создано | Временная метка Unix | Указывает, когда был создан ответ. |
| модель | модельная строка | Соответствует запрошенному значению модели. |
| размер | запрошенный размер | Соответствует размеру, принятому конечной точкой. |
| данные[].url | актив URL | Возвращается, когда формат_ответа равен URL-адресу. |
| данные[].b64_json | данные об активах base64 | Возвращается, когда формат ответа равен b64_json. |
{
"id": "img_example",
"created": 1783372800,
"model": "ucx-image-1",
"size": "1024x1024",
"data": [
{
"url": "https://unlimitedcodex.com/v1/images/example.png",
"revised_prompt": "A clean product illustration of an API usage dashboard."
}
]
}{
"model": "ucx-image-1",
"prompt": "A simple square app icon for an internal tool.",
"n": 1,
"size": "512x512",
"response_format": "b64_json"
}Ограничения и ошибки
Планируйте использование изображений и полные ответы.
Рабочие процессы запроса изображений могут создавать более резкие скачки использования, чем запросы только с текстом. Проверьте соответствие пакета и обработку ошибки 429 перед запуском кампаний или пакетных заданий.
Текущая конечная точка изображения не передает частичный прогресс; ответ возвращается после завершения запроса.
Каждый возвращенный элемент изображения регистрируется для обеспечения видимости использования, и каждый вызов считается как один запрос.
Текст подсказки также способствует составлению токенов и сметы затрат.
Используйте небольшие значения n при проверке рабочего процесса, а затем увеличивайте их только тогда, когда продукту требуется несколько вариантов.
Обработайте 429 ответов о скорости до того, как задания фонового изображения приведут к заметному пользователю сбою.
FAQ
Вопросы по запросу изображения.
Какую конечную точку изображения мне следует вызвать?
Используйте POST /v1/images/generations с ключом носителя API, телом запроса JSON, моделью, подсказкой, необязательным количеством изображений, необязательным размером и необязательным форматом ответа.
Какая область действия требуется для ключа изображения?
Используйте ключ API с областью images:write. Храните его на стороне сервера и никогда не раскрывайте его в коде браузера, мобильных пакетах, журналах или сообщениях поддержки.
Могут ли запросы изображений отслеживать прогресс?
Нет. Текущая конечная точка возвращает полный ответ после завершения запроса. Создавайте в своем приложении удобные для пользователя состояния загрузки и обработку тайм-аутов.
Должен ли я запрашивать URL или b64_json?
Используйте URL-адрес, если ваше приложение может получить или сохранить ссылку на актив. Используйте b64_json, если вашему приложению нужны встроенные данные изображения и оно может обрабатывать тела ответов большего размера.
Бесплатные инструменты
Планирование объема запроса изображений
Проверяйте полезные данные, оценивайте влияние квот, сравнивайте стоимость пакетов и создавайте фрагменты запросов перед запуском.
Запросить валидатор
Проверьте полезные данные чата, встраивания и изображений JSON на соответствие правилам, совместимым с unlimitedcodex OpenAI.
Оценщик квот
Преобразуйте MAU и подсказывайте предположения в ежемесячные токены, запросы и предупреждения о пороговых значениях квоты.
Калькулятор стоимости
Оцените ежемесячные расходы OpenAI и сравните их с фиксированными unlimitedcodex еженедельными или ежемесячными пакетами.
Запросить конструктор
Создайте визуальное завершение чата JSON и экспортируйте фрагменты cURL, JavaScript или Python.
Следующий шаг
Обработка запросов изображений в сочетании с ограничениями скорости и обработкой ошибок.
Прежде чем клиенты будут зависеть от вывода изображения, подтвердите политику запросов, использование изображений, поведение при повторных попытках и хранилище ответов.