Developer guide

Ката коддору

Статус коддору боюнча аракеттер жана кайра аракет кылуу эрежелери

Бул бетте шлюз кайтарган статус коддору жана алардын мааниси, ошондой эле ар бир код боюнча көрүлө турган аракеттер жыйынтыкталган.
Upstream 4xx·5xx кайтарса, ал код ошол бойдон өткөрүлөт, ал эми башка учурларда төмөнкү таблица колдонулат.
Эки шайкештик спецификациясындагы ката денесинин форматы жана Anthropic шайкеш error.type эрежелери, ошондой эле чектөөлөрдү жана колдонуу көлөмүн текшерүүчү консоль экраны да камтылган.

Статус коду

КодМаанисиАракет
400Сурамдын мааниси туура эмес. Anthropic шайкеш моделдер тизмесиндеги limit 1–1000 диапазонунан тышкары же GET /responses/{responseId}?stream=true аркылуу сакталган жоопту улантууга аракет жасалганМаанини уруксат берилген диапазонго тууралаңыз. Сакталган жоопту stream параметринсиз алыңыз.
401Ачкыч жок же мөөнөтү бүткөн/жокко чыгарылган ачкычAPI ачкычтары экранынан ачкычтын абалын текшериңиз жана баш аталыштын атын менен Bearer префиксин карап чыгыңыз.
403Моделге кирүү укугу жок, колдонуу чегинен ашты, кредит жетишсиз, же voice ээси эмесerror.message себебин айырмалап көрсөтөт. Маалыматты төмөндөгү чектөөлөрдү жана колдонуу көлөмүн текшерүү бөлүмүндөгү экрандан көрүңүз.
404Модель жок же бул ачкыч менен ага кирүү мүмкүн эмес (колдоосу токтотулган моделдерди кошкондо), жол жок, же сактоо мөөнөтү 3 күндөн ашкан CleviDrive натыйжасыАдегенде GET /models аркылуу чакырууга боло турган моделдердин тизмесин текшериңиз. Жолду API чакыруу бетиндеги таблица менен салыштырыңыз.
408 · 409 · 413Upstream убакыты бүттү, тыгын пайда болду же сурамдын өлчөмү чектен ашты. Үн·voice жолдору үчүн убакыт чеги 5 мүнөт, ал эми сурамдын жогорку чеги 28 MiB409 жообунда Retry-After болсо, көрсөтүлгөн убакытка күтүңүз. 413 болсо, сурамды бөлүп жөнөтүңүз.
429Upstream провайдери ылдамдыкты чектеген учурдаRetry-After берилсе, аны ошол бойдон аткарыңыз, берилбесе экспоненциалдык артка чегинүү менен кайра аракет кылыңыз.
5xxШлюздун же upstream'дин убактылуу катасы (анын ичинде 503)Экспоненциалдык артка чегинүү менен кайра аракет кылыңыз. Кайталана берсе, X-Request-Id менен бирге жардам бөлүмүнө жана колдоо кызматына кабарлаңыз.

Кайра аракет кылуу

Шлюз өз алдынча 429 түзбөйт, upstream жоопторун жашыруун түрдө кайра аракет кылбайт жана кезекке да койбойт.
Күтүү жана кайра аракет кылуу кардар тарабынан аткарылат.

КодКүтүү убактысыАндан кийин
409Retry-After болсо, ошол убакытОшол эле сурамды кайра жөнөтүңүз.
429Retry-After болсо, ошол убакыт, болбосо экспоненциалдык артка чегинүүОшол эле сурамды кайра жөнөтүңүз.
5xxЭкспоненциалдык артка чегинүүКайталана берсе, кайрылыңыз.
413Күтүүнүн кереги жокСурамды бөлүктөргө бөлүп жөнөтүңүз.

Ката мазмуну

Ката мазмунунун түзүлүшү спецификацияга жараша айырмаланат. Жогорку агымдагы каталарды билдирүүсүн гана калтырып, ирээттеп өткөрөбүз; стек жана ички талаалар өткөрүлбөйт.

OpenAI шайкеш жолдун мазмуну.

{
  "error": {
    "message": "API key is required.",
    "type": "invalid_request_error"
  }
}

Anthropic шайкеш жолдун мазмуну. error.type абал кодуна жараша аныкталат.

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "..."
  },
  "request_id": "rqid..."
}
Anthropic шайкеш error.type
Абал кодуerror.type
400invalid_request_error
401authentication_error
403permission_error
404not_found_error
413request_too_large
429rate_limit_error
529overloaded_error
Башка коддорapi_error

Чектерди жана колдонуу көлөмүн текшерүү

Чек көрсөткүчтөрү ар бир иш мейкиндигине жараша айырмаланат. 403 себебин error.message аркылуу текшерип, андан кийин төмөнкү экрандан көрсөткүчтөрдү көрүңүз.

Текшериле турган нерсеКонсолдун экраны
Менин иш мейкиндигиме коюлган чекОбзордогу бөлүнгөн колдонуу чеги
План уруксат берген диапазон жана калдыкПлан жана кредиттер
Чыныгы колдонуу көлөмү (модель жана ачкыч боюнча чалуулар, болжолдуу алынуучу кредиттер)Колдонуу көлөмү
Ачкычтын абалы (мөөнөтү бүткөнбү же жокко чыгарылганбы)API ачкычы
CLEVI

Тил жана аймак

Машина аркылуу которулган тилдер белгиленген. Жеткиликтүүлүк жарыяланган сайт топтомуна жараша болот.

136 тил

Сунушталат

1

Чыгыш Азия

7

Түштүк-Чыгыш Азия

11

Түштүк Азия

18

Борбор Азия

5

Жакынкы Чыгыш жана Кавказ

10

Батыш Европа жана Түштүк Европа

16

Улуу Британия жана Ирландия

4

Түндүк Европа

10

Борбордук Европа жана Балкан

14

Чыгыш Европа

5

Чыгыш Африка

8

Батыш Африка жана Борбордук Африка

9

Түштүк Африка

8

Америка

5

Океания

5