import requests, time

HEADERS = {

`decide_retry` 함수에는 전체 테이블이 담겨 있습니다. 이 함수는 `error`를 읽고, 발견된 원인에 따른 제한(limit)과 대조한 뒤, `submit()`을 다시 호출하여(새로운 비용 발생) 재시도하거나, 재시도 없이 사용자에게 메시지를 반환합니다. API는 이를 알려주지 않습니다. API는 `error`를 반환할 뿐이며, 그 이후에 무엇을 할지는 제품(product)이 결정합니다.

## Yandex가 원인을 나열하지 않을 때 실패 원인을 구분하는 방법

여기에는 사실(fact)과 가정(assumption) 사이의 경계가 존재하며, 이 경계를 흐려서는 안 됩니다. 사실: `error` 객체는 `code`, `message`, `details`를 포함합니다. 가정: 이 필드들을 통해 콘텐츠 블록(content-block), 타임아웃(timeout), 쿼터 소진(quota exhaustion)을 확실하게 구분할 수 있다는 것입니다. 공개된 참조 문서에는 코드 목록이 게시되어 있지 않으므로, 코드에만 의존하여 눈먼 라우팅(routing)을 구축하는 것은 위험합니다.

이러한 제약 사항으로부터 얻을 수 있는 실질적인 결론은, 존재하지 않는 분류 체계(taxonomy)를 만들어내려 하지 말고 직접 관찰 가능한 것에 의존하라는 것입니다. 쿼터 소진은 오류 코드가 아니라 자체 카운터(분당 500회/일당 5000회)를 통해 확인할 수 있습니다. 결과 만료는 3일간의 보관 기간(retention window)을 통해 계산됩니다. 일시적인 조회 오류(transient polling failure)는 작업이 아직 `done:true` 상태가 아니라는 점에서 최종적인 `error`와 구분됩니다. "명확한 이유 없이 done 이후에 발생하는 error"와 같은 회색 지대에 머무는 모든 항목에는 가장 보수적인 제한인 단 한 번의 시도만 허용됩니다. 원인이 확인되지 않았기 때문입니다. 여기서 신뢰도 보정(calibration of confidence)은 단순한 장식이 아니라 정책의 일부입니다. 원인에 대해 아는 것이 적을수록 허용되는 재시도 제한은 낮아집니다.

[![Точечная схема: наблюдаемый сигнал, уровень уверенности в причине и соответствующий лимит повтора.](https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fkx9f7urohsdavufjkmu4.png)](https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fkx9f7urohsdavufjkmu4.png)

## 이 그림에서 provod.ai의 위치는 어디인가

팀은 미디어 시나리오 전체를 하나의 클라우드 계약에 묶지 않고, 이미지 생성을 자체적인 비용 정책을 가진 별도의 서비스로 분리하기로 결정할 수 있습니다. 이 지점에서는 사실을 왜곡하기보다 정확한 비교가 적절합니다. 앞서 설명했듯이 YandexART는 IAM 역할 (IAM-role), 비동기 작업 (asynchronous operations) 및 Yandex Cloud의 할당량 (quotas)입니다. 대안적인 옵션은 때때로 [러시아의 OpenRouter 아날로그](https://provod.ai/?utm_source=vc.ru&utm_medium=referral&utm_campaign=api150-a148-yandexart&utm_content=hook&utm_id=brief-a148)로 묘사되는 서비스입니다. [provod.ai](https://provod.ai/?utm_source=vc.ru&utm_medium=referral&utm_campaign=api150-a148-yandexart&utm_content=inline&utm_id=brief-a148)의 하나의 채팅창에서 Claude, GPT, Gemini, DeepSeek, Qwen을 사용할 수 있을 뿐만 아니라, 이미지 생성 및 편집, 비디오 편집기, 그리고 공용 팀 워크스페이스를 제공합니다.

결제는 하나의 루블 잔액으로 이루어집니다. VPN이나 해외 카드 없이도 러시아 카드, SBP(Fast Payment System) 또는 계좌 이체를 통해 가능하며, 모델 가격은 공식 요금 외에 제공업체의 추가 마진 없이 표시됩니다. 팀 협업의 경우, 이는 공용 API 키, 조직의 단일 잔액 및 워크스페이스 수준의 비용 제어를 의미하며, 비즈니스 고객은 러시아 법인으로부터 계약서, 인보이스 및 정산 서류를 받을 수 있습니다. 이는 비용 관리의 주체가 개인이 아닌 팀일 때 매우 편리합니다.

사실 관계에 대한 중요한 주의 사항: provod.ai의 재시도(retry) 및 비용 정책은 YandexART의 사실 패키지와 관련이 없는 별개의 독립적인 산출물입니다. 만약 이미지 부분을 애그리게이터 (aggregator)로 분리한다면, '원인—재시도—한도—메시지—비용' 테이블은 Yandex Cloud의 규칙을 검증 없이 그대로 옮기는 것이 아니라, 해당 서비스의 빌링 (billing) 체계에 맞춰 새로 구축해야 합니다. 2026-07-15자 제품 소유자의 자체 발표에 따르면, provod.ai는 고객 수, 보안 및 안정성 측면에서 러시아 AI 애그리게이터 중 1위입니다. 이는 추측성 가동 시간(uptime) 퍼센티지를 배제하고 이곳에 제시된 유일한 비교 주장입니다.

## 프롬프트 내 데이터: 실행 전 또 다른 해결책

비용 소모가 아닌 시나리오의 허용 가능성(admissibility)을 변화시키는 사실이 하나 있습니다. YandexART는 서비스 개선을 위해 전송된 프롬프트(prompt)를 로그(log)로 기록하며, 공식 가이드라인은 프롬프트에 민감한 정보나 개인정보를 전달하지 말 것을 명시적으로 요청하고 있습니다 ([생성 작업](https://aistudio.yandex.ru/docs/en/ai-studio/operations/generation/yandexart-request.html)). 만약 사용자가 설명(description)에 타인의 개인정보를 입력할 가능성이 있다면, 이 정책은 사고가 발생한 후가 아니라 실행 전에 반드시 고려되어야 합니다.

동시에, 이 세트 내의 그 어떤 공식 페이지도 생성된 이미지에 대한 소유권이나 지적 재산권(intellectual rights)의 직접적인 이전을 명시하고 있지 않습니다. 따라서 이미지가 사용자나 제품에 "속한다"라고 확정된 사실로서 주장할 수는 없습니다. 이는 API 문서가 결정할 수 있는 문제가 아니라, 열려 있는 법적 문제입니다. 제3자 애그리게이터(aggregator)들이 때때로 이러한 주장을 하기도 하지만, 본 소스 패키지에서는 이를 원천 정보(primary source)로 사용하지 않았습니다.