Краткий ответ
- Установите таймаут 360 секунд для синхронных эндпоинтов генерации изображений. У генерации изображений нет async task ID — если разорвать соединение раньше, с вас все равно будет списана тарификация, но изображение вы не получите.
- Дайте reasoning-моделям достаточно времени.
gemini-3.1-pro-preview,gpt-5.6-solиgpt-5.5-proмогут выполняться несколько минут, независимо от того, используете вы потоковую передачу или нет. - Никогда не пропускайте длительные запросы через узел CDN.
api-cf.apiyi.comнаходится за Cloudflare и возвращает524примерно после 100 секунд; он подходит только для быстрых текстовых вызовов.
429 (недостаточно параллельных запросов), обратитесь в поддержку, чтобы проверить вашу квоту.Шпаргалка по тайм-аутам
Четыре ключа подробно
① Синхронные эндпоинты изображений: установите таймаут на 360 секунд
① Синхронные эндпоинты изображений: установите таймаут на 360 секунд
- GPT-Image-2 при
highкачестве с 2K/4K на практике занимает 3-5 минут - Генерация 4K в Nano Banana начинается примерно с 50 секунд и на пике длится дольше
- Задачи с несколькими референсными изображениями часто превышают 5 минут
② Модели рассуждения: медленные как со streaming, так и без него
② Модели рассуждения: медленные как со streaming, так и без него
gemini-3.1-pro-previewgpt-5.6-solgpt-5.5-pro(дороже и медленнее)- Любая модель, работающая с высоким уровнем рассуждения
stream=True означает немедленное поступление данных, но модель рассуждения может не выдавать никаких tokens вообще во время фазы размышления, поэтому ваш таймаут чтения все равно срабатывает — и общее время от первого token до последнего по-прежнему велико.Рекомендация: установите таймаут на 300-600 секунд для моделей рассуждения и соотнесите свой уровень рассуждения (reasoning_effort / thinking) со временем, которое вы выделили — более высокий уровень требует большего запаса.③ Выбор базового URL: CDN-узел не выдерживает длинные запросы
③ Выбор базового URL: CDN-узел не выдерживает длинные запросы
api-cf.apiyi.com APIYI обслуживается глобальной CDN Cloudflare. Она обеспечивает ускорение по всему миру и низкую задержку из-за рубежа, но у нее есть таймаут запроса примерно 100 секунд, после чего вы получаете ошибку 524.⚠️ Это касается не только image endpoints. Любой вызов, который может превысить 100 секунд, плохо подходит, включая:- ❌ Генерацию / редактирование изображений
- ❌ Генерацию видео
- ❌ Длинный текстовый вывод (длинные статьи, большие переводы, крупные генерации кода)
- ❌ Задачи с глубоким рассуждением на моделях рассуждения
api.apiyi.com (рекомендуется в материковом Китае) или vip.apiyi.com (рекомендуется за рубежом). Полное сравнение узлов — в Руководстве по базовому URL.④ Превышение лимитов параллельных запросов 429: обратитесь в поддержку
④ Превышение лимитов параллельных запросов 429: обратитесь в поддержку
429 Too Many Requests, проблема обычно в квоте параллельных запросов, а не в вашем таймауте.Лимиты параллельных запросов действуют для каждой модели отдельно, а не для всего вашего аккаунта. У конкретной модели — особенно у недавно запущенной или дефицитной — может быть более низкая квота.Что делать:- Реализуйте exponential backoff, чтобы не забивать лимит всплесками
- Если 429 сохраняются, обратитесь в поддержку APIYI — мы можем проверить фактическую квоту этой модели и помочь ее скорректировать
Примеры кода
- Python
- Node.js
- cURL
Все еще возникает тайм-аут после увеличения времени ожидания? Проверьте каждый участок пути
Шаг 1: Подтвердите, что тайм-аут SDK действительно применяется
Шаг 2: Проверьте каждый участок пути
- Самостоятельно размещенный обратный прокси: Nginx
proxy_read_timeout(60с по умолчанию) - Облачный балансировщик нагрузки: тайм-аут неактивного соединения
- API gateway / CDN: тайм-аут origin
- Serverless-функции: лимит выполнения (часто 30-60с по умолчанию)
- Воркеры очереди задач: тайм-аут для каждой задачи
Шаг 3: Подтвердите, что вы не на узле CDN
api-cf.apiyi.com. Для длительных запросов переключитесь на api.apiyi.com или vip.apiyi.com.Как правило, 524 почти всегда означает тайм-аут на уровне Cloudflare, а не медленную модель.Шаг 4: Отличайте тайм-ауты от лимитов параллельных запросов
524 и разорванные соединения — это проблемы с тайм-аутом; 429 — это проблема квоты. Способы исправления совершенно разные.Шаг 5: Проверьте журналы вызовов на фактическую задержку
Частые вопросы
Могу ли я получить возврат средств за запрос, который завершился по таймауту?
Могу ли я получить возврат средств за запрос, который завершился по таймауту?
Можете ли вы предложить асинхронный endpoint, чтобы я мог получить результаты по ID после разрыва соединения?
Можете ли вы предложить асинхронный endpoint, чтобы я мог получить результаты по ID после разрыва соединения?
Потоковая передача предотвращает таймауты?
Потоковая передача предотвращает таймауты?
Есть ли недостаток в том, чтобы установить очень большой таймаут?
Есть ли недостаток в том, чтобы установить очень большой таймаут?
В чем разница между 524 и 429?
В чем разница между 524 и 429?
524: таймаут на уровне Cloudflare, то есть вы использовалиapi-cf.apiyi.com, и запрос превысил примерно 100 секунд. Переключитесь на другие узлы.429: лимит параллельных запросов или rate limit, не связанный с длительностью. Добавьте экспоненциальную задержку между повторами и обратитесь в поддержку, если это сохраняется.
Related Documentation
Лучшие практики Image API
Как задать базовый URL?
Эндпоинты для изображений синхронные или асинхронные?
Сколько параллельных запросов я могу использовать?
Свяжитесь с нами
Поддержка WeCom
