오른쪽의 플레이그라운드를 사용해 요청을 직접 전송하십시오: Authorization에 Bearer sk-your-api-key를 넣으십시오. 예제에는 이미 reasoning_effort: "none"이 포함되어 있으며, 전송을 눌러 응답을 확인하십시오.
모델은 기본적으로 추론합니다(티어 xhigh, 출력으로 과금됩니다). 이 예제는 디버깅을 빠르고 저렴하게 유지하기 위해 추론을 비활성화합니다. 어려운 추론의 경우 reasoning_effort 필드를 제거하고 max_tokens를 4000 이상으로 올리십시오. 전체 설명은 Qwen3.8-Max 개요를 참조하십시오.
1. max_tokens는 추론을 제한하지 않습니다.max_tokens=1를 설정했지만 여전히 출력 token 1,054개(그중 1,045개는 추론)로 청구되었습니다. 비용을 제어하려면 reasoning_effort="none"를 사용하십시오.2. 강제 도구 호출에는 추론을 꺼야 합니다.tool_choice가 "required" 또는 이름이 지정된 함수로 설정된 경우, 추론 모드에서는 400이 반환되거나 호출이 조용히 건너뛰어집니다 — 함께 reasoning_effort="none"를 전달하십시오.3. thinking_budget는 아무 효과가 없습니다. 어떤 값이든 low 티어와 동일하게 동작합니다. 대신 reasoning_effort를 사용하십시오.
Usage stats. Some upstream routes do not report reasoning_tokens or cached_tokens
Show child attributes
이 페이지가 도움이 되었나요?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"API易文档中心","description":"企业级专业稳定的AI大模型API中转站,一个令牌、无限模型。支持OpenAI、Claude、Gemini、DeepSeek、Qwen等400+热门AI模型。","colors":{"primary":"#2563eb","light":"#3b82f6","dark":"#1d4ed8"},"logo":{"light":"https://mintcdn.com/apiyillc/LjCT1O0GrSur6F2v/logo/light.svg?fit=max\u0026auto=format\u0026n=LjCT1O0GrSur6F2v\u0026q=85\u0026s=4119ef17a74cc54be127f34578d8b5fa","dark":"https://mintcdn.com/apiyillc/LjCT1O0GrSur6F2v/logo/dark.svg?fit=max\u0026auto=format\u0026n=LjCT1O0GrSur6F2v\u0026q=85\u0026s=1f046ae9580247d96549ade642b5ecc4"},"favicon":"https://mintcdn.com/apiyillc/OMY6ItCc2mC1yzgA/logo/logo.webp?fit=max\u0026auto=format\u0026n=OMY6ItCc2mC1yzgA\u0026q=85\u0026s=62a7977ef801070e689df2d0291b9d13","api":{"openapi":["api-reference/nano-banana-2-generate-openapi.yaml","api-reference/nano-banana-2-edit-openapi.yaml","api-reference/nano-banana-2-generate-openapi-en.yaml","api-reference/nano-banana-2-edit-openapi-en.yaml","api-reference/nano-banana-pro-generate-openapi.yaml","api-reference/nano-banana-pro-edit-openapi.yaml","api-reference/nano-banana-pro-generate-openapi-en.yaml","api-reference/nano-banana-pro-edit-openapi-en.yaml","api-reference/gpt-image-2-all-generate-openapi.yaml","api-reference/gpt-image-2-all-edit-openapi.yaml","api-reference/gpt-image-2-all-generate-openapi-en.yaml","api-reference/gpt-image-2-all-edit-openapi-en.yaml","api-reference/gpt-image-2-all-chat-openapi.yaml","api-reference/gpt-image-2-all-chat-openapi-en.yaml","api-reference/gpt-image-2-vip-generate-openapi.yaml","api-reference/gpt-image-2-vip-edit-openapi.yaml","api-reference/gpt-image-2-vip-chat-openapi.yaml","api-reference/gpt-image-2-vip-generate-openapi-en.yaml","api-reference/gpt-image-2-vip-edit-openapi-en.yaml","api-reference/gpt-image-2-vip-chat-openapi-en.yaml"],"playground":{"display":"interactive","proxy":true},"examples":{"defaults":"required"}},"navbar":{"links":[{"href":"https://api.apiyi.com","label":"首页"},{"href":"https://imagen.apiyi.com","label":"AI出图"},{"href":"https://icover.ai","label":"AI视频"}],"primary":{"type":"button","label":"控制台","href":"https://api.apiyi.com/account/profile"}},"footer":{"socials":{"website":"https://api.apiyi.com"},"links":[{"header":"AI 集成","items":[{"label":"skill.md","href":"https://docs.apiyi.com/skill.md"},{"label":"llms.txt","href":"https://docs.apiyi.com/llms.txt"},{"label":"llms-full.txt","href":"https://docs.apiyi.com/llms-full.txt"},{"label":"model-registry.json","href":"https://docs.apiyi.com/model-registry.json"},{"label":"AI 开发者套件(中文)","href":"/developer-kit"},{"label":"AI Developer Kit (EN)","href":"/en/developer-kit"}]},{"header":"用户口碑 / Wall of Love","items":[{"label":"用户口碑(中文)","href":"/wall-of-love"},{"label":"Wall of Love (EN)","href":"/en/wall-of-love"}]}]},"seo":{"indexing":"all"},"icons":{"library":"lucide"},"banner":{"content":"🚀 **gemini-4-argon 和 Nano Banana 2.1 均已上线 | Now Live**:[详情 Details](https://docs.apiyi.com/changelog)","dismissible":true},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","aistudio"],"display":"header"},"metadata":{"timestamp":false},"styling":{"latex":true},"navigation":{"global":{"anchors":[]},"languages":[{"language":"zh","href":""},{"language":"en","navbar":{"links":[{"href":"https://api.apiyi.com","label":"Home"},{"href":"https://imagen.apiyi.com","label":"AI Image"},{"href":"https://icover.ai","label":"AI Video"}],"primary":{"type":"button","label":"Console","href":"https://api.apiyi.com/account/profile"}},"href":"en"},{"language":"zh-Hant","banner":{"content":"本頁由程式自動轉換為繁體中文,用詞以台灣正體為準;如有歧義請以[簡體中文版](/)為準。","dismissible":true},"footer":{"socials":{"website":"https://api.apiyi.com"},"links":[{"header":"AI 整合","items":[{"label":"skill.md","href":"https://docs.apiyi.com/skill.md"},{"label":"llms.txt","href":"https://docs.apiyi.com/llms.txt"},{"label":"llms-full.txt","href":"https://docs.apiyi.com/llms-full.txt"},{"label":"model-registry.json","href":"https://docs.apiyi.com/model-registry.json"},{"label":"AI 開發者套件(中文)","href":"/developer-kit"},{"label":"AI Developer Kit (EN)","href":"/en/developer-kit"}]},{"header":"使用者口碑 / Wall of Love","items":[{"label":"使用者口碑(中文)","href":"/wall-of-love"},{"label":"Wall of Love (EN)","href":"/en/wall-of-love"}]}]},"navbar":{"links":[{"href":"https://api.apiyi.com","label":"首頁"},{"href":"https://imagen.apiyi.com","label":"AI出圖"},{"href":"https://icover.ai","label":"AI影片"}],"primary":{"type":"button","label":"控制台","href":"https://api.apiyi.com/account/profile"}},"href":"zh-Hant"},{"language":"ja","banner":{"content":"このページは AI により翻訳されています。内容に相違がある場合は[English 版](/en)を正としてください。","dismissible":true},"footer":{"socials":{"website":"https://api.apiyi.com"},"links":[{"header":"AI統合","items":[{"label":"skill.md","href":"https://docs.apiyi.com/skill.md"},{"label":"llms.txt","href":"https://docs.apiyi.com/llms.txt"},{"label":"llms-full.txt","href":"https://docs.apiyi.com/llms-full.txt"},{"label":"model-registry.json","href":"https://docs.apiyi.com/model-registry.json"},{"label":"AI開発者キット(中国語)","href":"/developer-kit"},{"label":"AI Developer Kit (EN)","href":"/en/developer-kit"}]},{"header":"ユーザーの声 / Wall of Love","items":[{"label":"ユーザーの声(中国語)","href":"/wall-of-love"},{"label":"Wall of Love(英語)","href":"/en/wall-of-love"}]}]},"navbar":{"links":[{"href":"https://api.apiyi.com","label":"ホーム"},{"href":"https://imagen.apiyi.com","label":"AI画像生成"},{"href":"https://icover.ai","label":"AI動画生成"}],"primary":{"type":"button","label":"コンソール","href":"https://api.apiyi.com/account/profile"}},"href":"ja"},{"language":"ko","banner":{"content":"이 페이지는 AI로 번역되었습니다. 내용이 다를 경우 [English 버전](/en)을 기준으로 하십시오.","dismissible":true},"footer":{"socials":{"website":"https://api.apiyi.com"},"links":[{"header":"AI 통합","items":[{"label":"skill.md","href":"https://docs.apiyi.com/skill.md"},{"label":"llms.txt","href":"https://docs.apiyi.com/llms.txt"},{"label":"llms-full.txt","href":"https://docs.apiyi.com/llms-full.txt"},{"label":"model-registry.json","href":"https://docs.apiyi.com/model-registry.json"},{"label":"AI 개발자 키트(중국어)","href":"/developer-kit"},{"label":"AI Developer Kit (EN)","href":"/en/developer-kit"}]},{"header":"사용자 후기 / Wall of Love","items":[{"label":"사용자 후기(중국어)","href":"/wall-of-love"},{"label":"Wall of Love (영문)","href":"/en/wall-of-love"}]}]},"navbar":{"links":[{"href":"https://api.apiyi.com","label":"홈"},{"href":"https://imagen.apiyi.com","label":"AI 이미지 생성"},{"href":"https://icover.ai","label":"AI 동영상 생성"}],"primary":{"type":"button","label":"콘솔","href":"https://api.apiyi.com/account/profile"}},"href":"ko"},{"language":"ru","banner":{"content":"Эта страница переведена с помощью ИИ. При расхождениях ориентируйтесь на [английскую версию](/en).","dismissible":true},"footer":{"socials":{"website":"https://api.apiyi.com"},"links":[{"header":"AI-интеграция","items":[{"label":"skill.md","href":"https://docs.apiyi.com/skill.md"},{"label":"llms.txt","href":"https://docs.apiyi.com/llms.txt"},{"label":"llms-full.txt","href":"https://docs.apiyi.com/llms-full.txt"},{"label":"model-registry.json","href":"https://docs.apiyi.com/model-registry.json"},{"label":"Набор AI-разработчика (кит.)","href":"/developer-kit"},{"label":"AI Developer Kit (EN)","href":"/en/developer-kit"}]},{"header":"Отзывы пользователей / Wall of Love","items":[{"label":"Отзывы пользователей (на китайском)","href":"/wall-of-love"},{"label":"Wall of Love (EN)","href":"/en/wall-of-love"}]}]},"navbar":{"links":[{"href":"https://api.apiyi.com","label":"Главная"},{"href":"https://imagen.apiyi.com","label":"Генерация изображений"},{"href":"https://icover.ai","label":"Генерация видео"}],"primary":{"type":"button","label":"Консоль","href":"https://api.apiyi.com/account/profile"}},"href":"ru"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"apiyillc","hasAudioNarration":false,"actualSubdomain":"apiyillc","customDomains":["docs.apiyi.com"],"gitSource":{"type":"github","owner":"pdmaker","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae6da363e428d6b587da4d0","collectionId":"b443c8bb-86fb-4ad7-a590-422a240d5bb3","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae6da363e428d6b587da4d0"},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{},"buildId":"6ae6da363e428d6b587da4d0","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"zh","tag":"首页","count":213},{"language":"en","tag":"Home","count":213},{"language":"ja","tag":"ホーム","count":213},{"language":"ko","tag":"홈","count":213},{"language":"ru","tag":"Главная","count":213},{"language":"zh-Hant","tag":"首頁","count":213},{"language":"zh","tag":"图片 API(官转)","count":80},{"language":"en","tag":"Image API (Official)","count":80},{"language":"ja","tag":"画像API(公式)","count":80},{"language":"ko","tag":"이미지 API (공식)","count":80},{"language":"ru","tag":"Image API (официальный)","count":80},{"language":"zh-Hant","tag":"圖片 API(官轉)","count":80},{"language":"zh","tag":"公告","count":76},{"language":"en","tag":"Announcements","count":76},{"language":"zh","tag":"AI风向标","count":73},{"language":"en","tag":"AI Radar","count":73},{"language":"zh","tag":"常见问题","count":63},{"language":"en","tag":"FAQ","count":63},{"language":"ja","tag":"FAQ","count":63},{"language":"ko","tag":"FAQ","count":63},{"language":"ru","tag":"FAQ","count":63},{"language":"zh-Hant","tag":"常見問題","count":63},{"language":"zh","tag":"使用场景","count":50},{"language":"en","tag":"Use Cases","count":50},{"language":"ja","tag":"活用例","count":50},{"language":"ko","tag":"활용 사례","count":50},{"language":"ru","tag":"Сценарии использования","count":50},{"language":"zh-Hant","tag":"使用場景","count":50},{"language":"zh","tag":"基础 API","count":47},{"language":"en","tag":"Basic API","count":47},{"language":"ja","tag":"基本API","count":47},{"language":"ko","tag":"기본 API","count":47},{"language":"ru","tag":"Базовый API","count":47},{"language":"zh-Hant","tag":"基礎 API","count":47},{"language":"zh","tag":"视频 API(官转)","count":38},{"language":"en","tag":"Video API (Official)","count":38},{"language":"ja","tag":"動画API(公式)","count":38},{"language":"ko","tag":"동영상 API (공식)","count":38},{"language":"ru","tag":"Video API (официальный)","count":38},{"language":"zh-Hant","tag":"影片 API(官轉)","count":38},{"language":"zh","tag":"模型价格","count":35},{"language":"en","tag":"Model Pricing","count":35},{"language":"ja","tag":"モデル料金","count":35},{"language":"ko","tag":"모델 요금","count":35},{"language":"ru","tag":"Цены на модели","count":35},{"language":"zh-Hant","tag":"模型價格","count":35},{"language":"zh","tag":"文本生成","count":27},{"language":"en","tag":"Text Generation","count":27},{"language":"ja","tag":"テキスト生成","count":27},{"language":"ko","tag":"텍스트 생성","count":27},{"language":"ru","tag":"Генерация текста","count":27},{"language":"zh-Hant","tag":"文本生成","count":27},{"language":"ja","tag":"課金とセキュリティ","count":17},{"language":"ko","tag":"결제 및 보안","count":17},{"language":"ru","tag":"Оплата и безопасность","count":17},{"language":"zh-Hant","tag":"充值與安全","count":17},{"language":"ja","tag":"NanoBananaベストプラクティス","count":15},{"language":"ko","tag":"NanoBanana 모범 사례","count":15},{"language":"ru","tag":"Лучшие практики NanoBanana","count":15},{"language":"zh-Hant","tag":"NanoBanana最佳實踐","count":15}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"models/models.css","content":".mp-layout{display:flex;gap:2.5rem;max-width:1400px;margin:0 auto;padding:2.5rem 1.5rem 4rem;font-size:15px;line-height:1.7;color:rgb(var(--gray-500, 113 115 119))}html.dark .mp-layout{color:rgb(var(--gray-400, 159 161 165))}.mp-rail{display:none}@media (min-width:1024px){.mp-rail{display:block;width:13rem;flex-shrink:0}}.mp-rail-nav{position:sticky;top:9.25rem;font-size:.875rem}.mp-rail-head{font-weight:600;margin:0 0 .375rem;color:rgb(var(--gray-900, 23 25 29))}html.dark .mp-rail-head{color:rgb(var(--gray-200, 223 225 229))}.mp-rail-link{display:block;padding:.22rem 0;color:rgb(var(--gray-500, 113 115 119));text-decoration:none;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.mp-content a,.mp-content code.mp-ep-rec,.mp-rail-link:hover{color:rgb(var(--primary, 37 99 235))}html.dark .mp-rail-link{color:rgb(var(--gray-400, 159 161 165))}html.dark .mp-content a,html.dark .mp-content code.mp-ep-rec,html.dark .mp-rail-link:hover{color:rgb(var(--primary-light, 59 130 246))}.mp-rail-vendors{max-height:45vh;overflow-y:auto}.mp-mt{margin-top:1rem}.mp-content{min-width:0;flex:1}.mp-content h2,.mp-title{color:rgb(var(--gray-900, 23 25 29))}.mp-title{font-size:2rem;font-weight:700;letter-spacing:-.02em;margin:0 0 .5rem}html.dark .mp-content strong,html.dark .mp-title{color:#fff}.mp-desc{color:rgb(var(--gray-500, 113 115 119));margin:0 0 1.5rem}html.dark .mp-content th,html.dark .mp-desc{color:rgb(var(--gray-400, 159 161 165))}.mp-content h2{font-size:1.375rem;font-weight:600;margin:2.75rem 0 1rem;padding-bottom:.45rem;border-bottom:1px solid rgb(var(--gray-200, 223 225 229)/.7);scroll-margin-top:12rem}@media (min-width:1024px){.mp-content h2{scroll-margin-top:16.5rem}}html.dark .mp-content h2{border-color:rgb(255 255 255/.1);color:#fff}.mp-content p,.mp-content ul{margin:.75rem 0}.mp-content ul{padding-left:1.4rem}.mp-content li{margin:.4rem 0}.mp-content strong{color:rgb(var(--gray-900, 23 25 29))}.mp-content a{text-decoration:none}.mp-content a:hover{text-decoration:underline}.mp-content code{font-size:.85em;background:rgb(var(--gray-100, 239 241 245)/.8);border:1px solid rgb(var(--gray-200, 223 225 229)/.7);padding:.1em .35em;border-radius:.375rem}html.dark .mp-content code{background:rgb(255 255 255/.06);border-color:rgb(255 255 255/.1)}.mp-content code.mp-ep-rec{background:rgb(var(--primary, 37 99 235)/.08);border-color:rgb(var(--primary, 37 99 235)/.45);font-weight:600}html.dark .mp-content code.mp-ep-rec{background:rgb(var(--primary-light, 59 130 246)/.14);border-color:rgb(var(--primary-light, 59 130 246)/.5)}.mp-content table{display:block;max-width:100%;overflow-x:auto;border-collapse:collapse;font-size:.875rem;margin:1rem 0 1.5rem}.mp-content td,.mp-content th{padding:.55rem 1.25rem .55rem 0;white-space:nowrap}.mp-content th{text-align:left;font-weight:500;color:rgb(var(--gray-500, 113 115 119));border-bottom:1px solid rgb(var(--gray-200, 223 225 229)/.7)}.mp-content td{border-bottom:1px solid rgb(var(--gray-200, 223 225 229)/.45)}html.dark .mp-content th{border-color:rgb(255 255 255/.1)}html.dark .mp-content td{border-color:rgb(255 255 255/.07)}.mp-search{display:contents}.mp-search-bar{position:sticky;top:5rem;z-index:20;margin:0 0 1.75rem;background:rgb(var(--background-light, 255 255 255));padding:.75rem 0 .85rem;box-shadow:0 10px 14px -10px rgb(var(--gray-950, 11 13 17)/.28)}@media (min-width:1024px){.mp-search-bar{top:9.25rem}}html.dark .mp-search-bar{background:rgb(var(--background-dark, 10 11 16));box-shadow:0 8px 12px -10px rgb(0 0 0/.7)}.mp-search-label{margin:0 0 .5rem;padding-left:.6rem;border-left:3px solid rgb(var(--primary, 37 99 235));font-size:.9rem;font-weight:600;line-height:1.4;color:rgb(var(--primary, 37 99 235))}html.dark .mp-search-label{border-left-color:rgb(var(--primary-light, 59 130 246));color:rgb(var(--primary-light, 59 130 246))}.mp-search-input{width:100%;box-sizing:border-box;border:1px solid rgb(var(--gray-400, 159 161 165)/.3);border-radius:.75rem;padding:.7rem 1rem .7rem 2.65rem;font-size:.9rem;background-color:rgb(var(--background-light, 255 255 255));background-image:url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='18' height='18' viewBox='0 0 24 24' fill='none' stroke='%23717377' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Ccircle cx='11' cy='11' r='8'/%3E%3Cpath d='m21 21-4.3-4.3'/%3E%3C/svg%3E\");background-repeat:no-repeat;background-position:.9rem center;color:rgb(var(--gray-900, 23 25 29));outline:0;transition:border-color .15s ease,background-color .15s ease,box-shadow .15s ease}.mp-search-input::placeholder{color:rgb(var(--gray-500, 113 115 119))}.mp-search-input:hover{border-color:rgb(var(--gray-600, 81 83 87)/.3)}.mp-search-input:focus{border-color:rgb(var(--primary, 37 99 235));box-shadow:0 0 0 3px rgb(var(--primary, 37 99 235)/.16)}html.dark .mp-search-input{background-color:rgb(var(--background-dark, 10 11 16));background-image:url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='18' height='18' viewBox='0 0 24 24' fill='none' stroke='%239fa1a5' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Ccircle cx='11' cy='11' r='8'/%3E%3Cpath d='m21 21-4.3-4.3'/%3E%3C/svg%3E\");border-color:rgb(var(--gray-600, 81 83 87)/.3);color:rgb(var(--gray-100, 239 241 245))}html.dark .mp-search-input::placeholder{color:rgb(255 255 255/.5)}html.dark .mp-search-input:hover{border-color:rgb(var(--gray-500, 113 115 119)/.35)}html.dark .mp-search-input:focus{border-color:rgb(var(--primary-light, 59 130 246));box-shadow:0 0 0 3px rgb(var(--primary-light, 59 130 246)/.22)}.mp-search-empty,.mp-search-meta{color:rgb(var(--gray-500, 113 115 119))}.mp-search-meta{font-size:.75rem;margin:.75rem 0 .25rem}.mp-search-empty{font-size:.875rem;margin-top:.75rem}html.dark .mp-search-empty,html.dark .mp-search-meta{color:rgb(var(--gray-400, 159 161 165))}.mp-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;font-size:.8125rem}@media (min-width:1024px){.mp-jump{display:none}}"},{"filePath":"styles/agent-prompt.css","content":"div.prompt{border:1.5px solid rgb(var(--primary, 37 99 235)/.35);background:rgb(var(--primary, 37 99 235)/.035);padding:1.25rem 1.25rem 1rem;row-gap:.75rem}html.dark div.prompt{border-color:rgb(var(--primary-light, 59 130 246)/.4);background:rgb(var(--primary-light, 59 130 246)/.06)}div.prompt [data-component-part=prompt-content-wrapper]{width:100%}div.prompt [data-component-part=prompt-actions-wrapper]{width:100%;justify-content:flex-end}div.prompt [data-component-part=prompt-description]{flex:1;font-size:14px;line-height:1.65}div.prompt [data-component-part=prompt-description]>div>*{margin:0}div.prompt [data-component-part=prompt-description]>div>*+*{margin-top:.6rem}div.prompt [data-component-part=prompt-description] strong{font-size:15px;font-weight:650;color:rgb(var(--gray-900, 23 25 29))}html.dark div.prompt [data-component-part=prompt-description] strong{color:#fff}div.prompt [data-component-part=prompt-description]>div>*+p{color:rgb(var(--gray-600, 80 82 86))}html.dark div.prompt [data-component-part=prompt-description]>div>*+p{color:rgb(var(--gray-400, 159 161 165))}div.prompt [data-component-part=prompt-description] code{font-size:.85em;background:rgb(var(--gray-100, 239 241 245)/.9);border:1px solid rgb(var(--gray-200, 223 225 229)/.7);padding:.05em .35em;border-radius:.375rem}html.dark div.prompt [data-component-part=prompt-description] code{background:rgb(255 255 255/.06);border-color:rgb(255 255 255/.1)}div.prompt [data-component-part=prompt-description] blockquote{margin:0;padding:.75rem .9rem;font-style:normal;border:1px dashed rgb(var(--gray-300, 191 193 197));border-radius:.6rem;background:rgb(var(--background-light, 255 255 255));font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;font-size:12.5px;line-height:1.6;color:rgb(var(--gray-600, 80 82 86));overflow-wrap:anywhere;-webkit-mask-image:linear-gradient(to bottom,#000 70%,transparent 100%);mask-image:linear-gradient(to bottom,#000 70%,transparent 100%)}div.prompt [data-component-part=prompt-description] blockquote ol,div.prompt [data-component-part=prompt-description] blockquote p{margin:0}div.prompt [data-component-part=prompt-description] blockquote li{padding:0}div.prompt [data-component-part=prompt-description] blockquote>*+*{margin-top:.5rem}div.prompt [data-component-part=prompt-description] blockquote code{background:0 0;border:0;padding:0;font-size:1em}div.prompt [data-component-part=prompt-description] blockquote a{color:inherit;text-decoration:none;pointer-events:none}html.dark div.prompt [data-component-part=prompt-description] blockquote{border-color:rgb(255 255 255/.15);background:rgb(var(--background-dark, 13 13 13));color:rgb(var(--gray-400, 159 161 165))}div.prompt [data-component-part=prompt-action-copy-button]{padding:.6rem 1.25rem;font-size:14px;line-height:20px;font-weight:600;border-radius:.65rem;gap:.45rem;box-shadow:0 1px 2px rgb(0 0 0/.08),0 4px 12px rgb(var(--primary, 37 99 235)/.25)}div.prompt [data-component-part=prompt-action-copy-button]::before{content:\"\";width:16px;height:16px;flex-shrink:0;background:currentColor;-webkit-mask:url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Crect width='14' height='14' x='8' y='8' rx='2' ry='2'/%3E%3Cpath d='M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2'/%3E%3C/svg%3E\") center/contain no-repeat;mask:url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Crect width='14' height='14' x='8' y='8' rx='2' ry='2'/%3E%3Cpath d='M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2'/%3E%3C/svg%3E\") center/contain no-repeat}div.prompt [data-component-part=prompt-action-copy-button] svg{width:12px;height:12px}@media (max-width:640px){div.prompt [data-component-part=prompt-actions-wrapper]>*{flex:1}}"}],"page":{"pagePath":"ko/api-capabilities/qwen-3-8/chat-completions","slug":"/ko/api-capabilities/qwen-3-8/chat-completions","pageMetadata":{"title":"Qwen3.8-Max Chat API 레퍼런스","sidebarTitle":"Chat 플레이그라운드","description":"Qwen3.8-Max Chat Completions API 레퍼런스 및 실시간 플레이그라운드: OpenAI 호환 형식에 reasoning_effort 단계, 스트리밍, 함수 호출, 이미지/동영상 입력을 지원합니다.","openapi":"api-reference/qwen-3-8-max-chat-openapi-en.yaml POST /v1/chat/completions","icon":"terminal","href":"/ko/api-capabilities/qwen-3-8/chat-completions"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Qwen3.8-Max Chat Completions API 레퍼런스 및 실시간 플레이그라운드: OpenAI 호환 형식에 reasoning_effort 단계, 스트리밍, 함수 호출, 이미지/동영상 입력을 지원합니다.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Info,Table,Tip,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Info,{children:_jsxs(_components.p,{children:[`오른쪽의 플레이그라운드를 사용해 요청을 직접 전송하십시오: `,_jsx(_components.strong,{children:`Authorization`}),`에 `,_jsx(_components.code,{children:`Bearer sk-your-api-key`}),`를 넣으십시오. 예제에는 이미 `,_jsx(_components.code,{children:`reasoning_effort: \"none\"`}),`이 포함되어 있으며, 전송을 눌러 응답을 확인하십시오.`]})}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`모델은 `,_jsx(_components.strong,{children:`기본적으로 추론합니다`}),`(티어 `,_jsx(_components.code,{children:`xhigh`}),`, 출력으로 과금됩니다). 이 예제는 디버깅을 빠르고 저렴하게 유지하기 위해 추론을 비활성화합니다. 어려운 추론의 경우 `,_jsx(_components.code,{children:`reasoning_effort`}),` 필드를 제거하고 `,_jsx(_components.code,{children:`max_tokens`}),`를 4000 이상으로 올리십시오. 전체 설명은 `,_jsx(_components.a,{href:`/ko/api-capabilities/qwen-3-8/overview`,children:`Qwen3.8-Max 개요`}),`를 참조하십시오.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`매개변수-빠른-참조`,children:`매개변수 빠른 참조`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`매개변수`}),_jsx(_components.th,{children:`유형`}),_jsx(_components.th,{children:`필수`}),_jsx(_components.th,{children:`참고`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`model`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`✓`}),_jsxs(_components.td,{children:[`항상 `,_jsx(_components.code,{children:`qwen3.8-max`}),`입니다`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`messages`})}),_jsx(_components.td,{children:`array`}),_jsx(_components.td,{children:`✓`}),_jsxs(_components.td,{children:[`표준 OpenAI 메시지 배열입니다. `,_jsx(_components.code,{children:`content`}),`는 멀티모달 배열일 수 있습니다(`,_jsx(_components.code,{children:`image_url`}),` / `,_jsx(_components.code,{children:`video_url`}),`는 데이터 URL을 허용합니다)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`max_tokens`})}),_jsx(_components.td,{children:`int`}),_jsx(_components.td,{}),_jsxs(_components.td,{children:[`보이는 답변에 대한 출력 예산이며, 범위는 `,_jsx(_components.code,{children:`[1, 131072]`}),`입니다. `,_jsx(_components.strong,{children:`추론 token을 제한하지 않습니다`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`reasoning_effort`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`none`}),` / `,_jsx(_components.code,{children:`minimal`}),` / `,_jsx(_components.code,{children:`low`}),` / `,_jsx(_components.code,{children:`medium`}),` / `,_jsx(_components.code,{children:`high`}),` / `,_jsx(_components.code,{children:`xhigh`}),` / `,_jsx(_components.code,{children:`max`}),`, 기본값은 `,_jsx(_components.code,{children:`xhigh`}),`입니다`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`stream`})}),_jsx(_components.td,{children:`bool`}),_jsx(_components.td,{}),_jsxs(_components.td,{children:[`SSE 스트리밍입니다. 이 엔드포인트는 `,_jsx(_components.code,{children:`stream_options`}),`가 없어도 최종 청크에 사용량을 반환합니다`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`response_format`})}),_jsx(_components.td,{children:`object`}),_jsx(_components.td,{}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`json_schema`}),` 구조화된 출력이며, 테스트에서 엄격하게 유지됩니다`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`tools`})}),_jsx(_components.td,{children:`array`}),_jsx(_components.td,{}),_jsx(_components.td,{children:`함수 호출 도구 목록이며, 동작이 검증되었습니다`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`tool_choice`})}),_jsx(_components.td,{children:`string/object`}),_jsx(_components.td,{}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`auto`}),` / `,_jsx(_components.code,{children:`none`}),`는 그대로 작동하며, `,_jsx(_components.code,{children:`required`}),` 또는 이름이 있는 함수에는 `,_jsx(_components.code,{children:`reasoning_effort: \"none\"`}),`가 필요합니다`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`n`})}),_jsx(_components.td,{children:`int`}),_jsx(_components.td,{}),_jsxs(_components.td,{children:[`1보다 큰 값에는 `,_jsx(_components.code,{children:`reasoning_effort: \"none\"`}),`가 필요합니다`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`temperature`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{}),_jsxs(_components.td,{children:[`유효 범위는 `,_jsx(_components.code,{children:`[0.0, 2.0)`}),`입니다. `,_jsx(_components.code,{children:`2`}),`를 전달하면 400을 반환합니다`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`stop`})}),_jsx(_components.td,{children:`array`}),_jsx(_components.td,{}),_jsx(_components.td,{children:`중지 시퀀스이며, 동작이 검증되었습니다`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`세-가지-쉬운-실수`,children:`세 가지 쉬운 실수`}),`\n`,_jsxs(Warning,{children:[_jsxs(_components.p,{children:[_jsxs(_components.strong,{children:[`1. `,_jsx(_components.code,{children:`max_tokens`}),`는 추론을 제한하지 않습니다.`]}),` `,_jsx(_components.code,{children:`max_tokens=1`}),`를 설정했지만 여전히 출력 token 1,054개(그중 1,045개는 추론)로 청구되었습니다. 비용을 제어하려면 `,_jsx(_components.code,{children:`reasoning_effort=\"none\"`}),`를 사용하십시오.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`2. 강제 도구 호출에는 추론을 꺼야 합니다.`}),` `,_jsx(_components.code,{children:`tool_choice`}),`가 `,_jsx(_components.code,{children:`\"required\"`}),` 또는 이름이 지정된 함수로 설정된 경우, 추론 모드에서는 400이 반환되거나 호출이 조용히 건너뛰어집니다 — 함께 `,_jsx(_components.code,{children:`reasoning_effort=\"none\"`}),`를 전달하십시오.`]}),_jsxs(_components.p,{children:[_jsxs(_components.strong,{children:[`3. `,_jsx(_components.code,{children:`thinking_budget`}),`는 아무 효과가 없습니다.`]}),` 어떤 값이든 `,_jsx(_components.code,{children:`low`}),` 티어와 동일하게 동작합니다. 대신 `,_jsx(_components.code,{children:`reasoning_effort`}),`를 사용하십시오.`]})]}),`\n`,_jsx(Heading,{level:`2`,id:`응답-읽기`,children:`응답 읽기`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`추론 흔적은 `,_jsx(_components.code,{children:`choices[0].message.reasoning_content`}),`에 있습니다(추론이 켜져 있을 때 반환됩니다)`]}),`\n`,_jsxs(_components.li,{children:[`추론 비용은 `,_jsx(_components.code,{children:`usage.completion_tokens_details.reasoning_tokens`}),`에, 캐시 적중은 `,_jsx(_components.code,{children:`usage.prompt_tokens_details.cached_tokens`}),`에 있습니다`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`일부 상위 라우트는 이 두 필드를 보고하지 않습니다`}),`(테스트에서 요청의 약 3분의 1) — 정확한 추론 비용 집계가 필요하다면 이 점을 염두에 두십시오`]}),`\n`,_jsxs(_components.li,{children:[`7개의 유효한 `,_jsx(_components.code,{children:`reasoning_effort`}),` 값은 실제로 4개의 등급에만 매핑됩니다; `,_jsx(_components.code,{children:`max`}),`는 `,_jsx(_components.code,{children:`xhigh`}),`보다 더 깊게 추론하지 않습니다`]}),`\n`,_jsxs(_components.li,{children:[`잘못된 `,_jsx(_components.code,{children:`reasoning_effort`}),` 값은 조용히 낮은 등급으로 대체하지 않고, 전체 유효 집합을 나열하는 400 응답을 반환합니다`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`관련`,children:`관련`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/ko/api-capabilities/qwen-3-8/overview`,children:`Qwen3.8-Max 개요`}),` — 전체 기능 매트릭스, 가격, 모범 사례`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/ko/api-capabilities/qwen-3-6/overview`,children:`Qwen3.6 시리즈(레거시)`}),` — 이전 5개 모델`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Qwen3.8-Max Chat API 레퍼런스","sidebarTitle":"Chat 플레이그라운드","description":"Qwen3.8-Max Chat Completions API 레퍼런스 및 실시간 플레이그라운드: OpenAI 호환 형식에 reasoning_effort 단계, 스트리밍, 함수 호출, 이미지/동영상 입력을 지원합니다.","openapi":"api-reference/qwen-3-8-max-chat-openapi-en.yaml POST /v1/chat/completions","icon":"terminal","href":"/ko/api-capabilities/qwen-3-8/chat-completions"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"매개변수 빠른 참조","slug":"매개변수-빠른-참조","depth":2,"children":[]},{"title":"세 가지 쉬운 실수","slug":"세-가지-쉬운-실수","depth":2,"children":[]},{"title":"응답 읽기","slug":"응답-읽기","depth":2,"children":[]},{"title":"관련","slug":"관련","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"chatqwen3_8_max","summary":"Chat completion: Qwen3.8-Max (OpenAI compatible)","description":"Qwen3.8-Max Chat Completions API 레퍼런스 및 실시간 플레이그라운드: OpenAI 호환 형식에 reasoning_effort 단계, 스트리밍, 함수 호출, 이미지/동영상 입력을 지원합니다.","tags":["Text Generation"],"security":["eb4e8da3-f47b-42ac-95a1-fde1edfee0ad"],"requestBody":"0b45904a-713e-4b90-b4f1-a985c6950b3d","responses":{"200":"00cb9399-376b-4449-8860-39edcc05dd71","400":"333dca97-f272-4891-a1c9-4e153c27635b","401":"8089f1e8-204c-4728-92b4-e4c86f25d85f","429":"17d043ad-57e0-498b-a8e0-c86581a6d5e0"},"method":"post","type":"path","servers":["d0beb782-7fe8-47b0-94d4-9f0a5dfd9c12"],"path":"/v1/chat/completions","baseUrlOptions":["https://api.apiyi.com"],"title":"Chat completion: Qwen3.8-Max (OpenAI compatible)","codeSamples":[],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["model","messages"],"properties":{"model":{"type":"string","description":"Always qwen3.8-max","isRequired":true,"uniqueKey":"model","typeLabel":"string"},"messages":{"type":"array","description":"Standard OpenAI message array","items":{"type":"object","properties":{"role":{"type":"string","enum":["system","user","assistant","tool"],"uniqueKey":"messages.items.[INDEX].role","typeLabel":"enum\u003cstring>"},"content":{"description":"String or multimodal array (text / image_url / video_url)","uniqueKey":"messages.items.[INDEX].content","typeLabel":"any"}},"uniqueKey":"messages.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"messages","typeLabel":"object[]"},"max_tokens":{"type":"integer","description":"Output budget for the visible answer, range [1, 131072]. Note: does not bound thinking tokens","uniqueKey":"max_tokens","typeLabel":"integer"},"reasoning_effort":{"type":"string","enum":["none","minimal","low","medium","high","xhigh","max"],"description":"Thinking tier, default xhigh. Measured to have only four real tiers: none / minimal≡low / medium / high≡xhigh≡max","uniqueKey":"reasoning_effort","typeLabel":"enum\u003cstring>"},"temperature":{"type":"number","description":"Valid range [0.0, 2.0); passing 2 returns 400","uniqueKey":"temperature","typeLabel":"number"},"top_p":{"type":"number","description":"Valid range (0.0, 1.0]","uniqueKey":"top_p","typeLabel":"number"},"top_k":{"type":"integer","uniqueKey":"top_k","typeLabel":"integer"},"stream":{"type":"boolean","description":"SSE streaming. This endpoint returns usage in the final chunk even without stream_options","uniqueKey":"stream","typeLabel":"boolean"},"stop":{"type":"array","description":"Stop sequences, verified working","items":{"type":"string","uniqueKey":"stop.items.[INDEX]","typeLabel":"string"},"uniqueKey":"stop","typeLabel":"string[]"},"response_format":{"type":"object","description":"Structured output; json_schema held strictly in testing. Pair it with reasoning_effort: none","uniqueKey":"response_format","typeLabel":"object"},"tools":{"type":"array","description":"Function calling tool list, verified working","items":{"type":"object","uniqueKey":"tools.items.[INDEX]","typeLabel":"object"},"uniqueKey":"tools","typeLabel":"object[]"},"tool_choice":{"description":"auto / none work as-is; required or a named function requires reasoning_effort: none","uniqueKey":"tool_choice","typeLabel":"any"},"parallel_tool_calls":{"type":"boolean","description":"Set false to limit to a single tool call, verified working","uniqueKey":"parallel_tool_calls","typeLabel":"boolean"},"n":{"type":"integer","description":"Number of candidates. Values above 1 require reasoning_effort: none","uniqueKey":"n","typeLabel":"integer"},"logprobs":{"type":"boolean","uniqueKey":"logprobs","typeLabel":"boolean"}},"uniqueKey":"","typeLabel":"object"},"example":{"model":"qwen3.8-max","messages":[{"role":"user","content":"Introduce yourself in one sentence."}],"max_tokens":1000,"reasoning_effort":"none"},"examples":{"Example":{"title":"Example","value":{"model":"qwen3.8-max","messages":[{"role":"user","content":"Introduce yourself in one sentence."}],"max_tokens":1000,"reasoning_effort":"none"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"00cb9399-376b-4449-8860-39edcc05dd71":{"description":"Chat completion succeeded","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","uniqueKey":"id","typeLabel":"string"},"model":{"type":"string","uniqueKey":"model","typeLabel":"string"},"choices":{"type":"array","items":{"type":"object","properties":{"message":{"type":"object","properties":{"role":{"type":"string","uniqueKey":"choices.items.[INDEX].message.role","typeLabel":"string"},"content":{"type":"string","uniqueKey":"choices.items.[INDEX].message.content","typeLabel":"string"},"reasoning_content":{"type":"string","description":"Thinking trace, returned while thinking is on","uniqueKey":"choices.items.[INDEX].message.reasoning_content","typeLabel":"string"},"tool_calls":{"type":"array","items":{"type":"object","uniqueKey":"choices.items.[INDEX].message.tool_calls.items.[INDEX]","typeLabel":"object"},"uniqueKey":"choices.items.[INDEX].message.tool_calls","typeLabel":"object[]"}},"uniqueKey":"choices.items.[INDEX].message","typeLabel":"object"},"finish_reason":{"type":"string","uniqueKey":"choices.items.[INDEX].finish_reason","typeLabel":"string"}},"uniqueKey":"choices.items.[INDEX]","typeLabel":"object"},"uniqueKey":"choices","typeLabel":"object[]"},"usage":{"type":"object","description":"Usage stats. Some upstream routes do not report reasoning_tokens or cached_tokens","properties":{"prompt_tokens":{"type":"integer","uniqueKey":"usage.prompt_tokens","typeLabel":"integer"},"completion_tokens":{"type":"integer","description":"Includes thinking tokens","uniqueKey":"usage.completion_tokens","typeLabel":"integer"},"total_tokens":{"type":"integer","uniqueKey":"usage.total_tokens","typeLabel":"integer"},"completion_tokens_details":{"type":"object","properties":{"reasoning_tokens":{"type":"integer","uniqueKey":"usage.completion_tokens_details.reasoning_tokens","typeLabel":"integer"}},"uniqueKey":"usage.completion_tokens_details","typeLabel":"object"},"prompt_tokens_details":{"type":"object","properties":{"cached_tokens":{"type":"integer","uniqueKey":"usage.prompt_tokens_details.cached_tokens","typeLabel":"integer"}},"uniqueKey":"usage.prompt_tokens_details","typeLabel":"object"}},"uniqueKey":"usage","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","model":"\u003cstring>","choices":[{"message":{"role":"\u003cstring>","content":"\u003cstring>","reasoning_content":"\u003cstring>","tool_calls":[{}]},"finish_reason":"\u003cstring>"}],"usage":{"prompt_tokens":123,"completion_tokens":123,"total_tokens":123,"completion_tokens_details":{"reasoning_tokens":123},"prompt_tokens_details":{"cached_tokens":123}}}}},"exampleType":"generated"}},"exampleType":"generated"},"333dca97-f272-4891-a1c9-4e153c27635b":{"description":"Invalid parameters. Common causes: forced tool_choice or n > 1 while thinking is on; an illegal reasoning_effort value; temperature outside [0.0, 2.0); max_tokens outside [1, 131072]","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"8089f1e8-204c-4728-92b4-e4c86f25d85f":{"description":"Invalid API key","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"17d043ad-57e0-498b-a8e0-c86581a6d5e0":{"description":"Rate limit exceeded","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"eb4e8da3-f47b-42ac-95a1-fde1edfee0ad":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Add Authorization: Bearer YOUR_API_KEY to the request header","scopes":[]}}},"servers":{"d0beb782-7fe8-47b0-94d4-9f0a5dfd9c12":{"url":"https://api.apiyi.com","description":"Primary endpoint"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Add Authorization: Bearer YOUR_API_KEY to the request header","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Add Authorization: Bearer YOUR_API_KEY to the request header","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/qwen-3-8-max-chat-openapi-en.yaml"},"subdomain":"apiyillc","siteName":"API易文档中心","title":"Qwen3.8-Max Chat API 레퍼런스 - API易文档中心","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"zh":{"href":"/api-capabilities/qwen-3-8/chat-completions","matchLevel":1},"en":{"href":"/en/api-capabilities/qwen-3-8/chat-completions","matchLevel":1},"zh-Hant":{"href":"/zh-Hant/api-capabilities/qwen-3-8/chat-completions","matchLevel":1},"ja":{"href":"/ja/api-capabilities/qwen-3-8/chat-completions","matchLevel":1},"ko":{"href":"/ko/api-capabilities/qwen-3-8/chat-completions","matchLevel":0},"ru":{"href":"/ru/api-capabilities/qwen-3-8/chat-completions","matchLevel":1}}},"lastModified":"2026-08-03T15:20:41.487Z","originalFileLocation":"ko/api-capabilities/qwen-3-8/chat-completions.mdx","locale":"ko"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Qwen3.8-Max Chat Completions API 레퍼런스 및 실시간 플레이그라운드: OpenAI 호환 형식에 reasoning_effort 단계, 스트리밍, 함수 호출, 이미지/동영상 입력을 지원합니다.\">\u003cmeta data-mint-head name=\"application-name\" content=\"API易文档中心\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Qwen3.8-Max Chat API 레퍼런스 - API易文档中心\">\u003cmeta data-mint-head property=\"og:description\" content=\"Qwen3.8-Max Chat Completions API 레퍼런스 및 실시간 플레이그라운드: OpenAI 호환 형식에 reasoning_effort 단계, 스트리밍, 함수 호출, 이미지/동영상 입력을 지원합니다.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"API易文档中心\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.apiyi.com/ko/api-capabilities/qwen-3-8/chat-completions\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://apiyillc.mintlify.app/_mintlify/api/og/v2?division=Qwen3+%EC%8B%9C%EB%A6%AC%EC%A6%88\u0026amp;title=Qwen3.8-Max+Chat+API+%EB%A0%88%ED%8D%BC%EB%9F%B0%EC%8A%A4\u0026amp;description=Qwen3.8-Max+Chat+Completions+API+%EB%A0%88%ED%8D%BC%EB%9F%B0%EC%8A%A4+%EB%B0%8F+%EC%8B%A4%EC%8B%9C%EA%B0%84+%ED%94%8C%EB%A0%88%EC%9D%B4%EA%B7%B8%EB%9D%BC%EC%9A%B4%EB%93%9C%3A+OpenAI+%ED%98%B8%ED%99%98+%ED%98%95%EC%8B%9D%EC%97%90+reasoning_effort+%EB%8B%A8%EA%B3%84%2C+%EC%8A%A4%ED%8A%B8%EB%A6%AC%EB%B0%8D%2C+%ED%95%A8%EC%88%98+%ED%98%B8%EC%B6%9C%2C+%EC%9D%B4%EB%AF%B8%EC%A7%80%2F%EB%8F%99%EC%98%81%EC%83%81+%EC%9E%85%EB%A0%A5%EC%9D%84+%EC%A7%80%EC%9B%90%ED%95%A9%EB%8B%88%EB%8B%A4.\u0026amp;theme=421dcf1ed22dd4b5d53fa3cb\u0026amp;signature=e37e5ffd34a78ac50f67c4f4b630f5f8173681a90e51223a36efde4952b4bd99\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Qwen3.8-Max Chat API 레퍼런스 - API易文档中心\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Qwen3.8-Max Chat Completions API 레퍼런스 및 실시간 플레이그라운드: OpenAI 호환 형식에 reasoning_effort 단계, 스트리밍, 함수 호출, 이미지/동영상 입력을 지원합니다.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://apiyillc.mintlify.app/_mintlify/api/og/v2?division=Qwen3+%EC%8B%9C%EB%A6%AC%EC%A6%88\u0026amp;title=Qwen3.8-Max+Chat+API+%EB%A0%88%ED%8D%BC%EB%9F%B0%EC%8A%A4\u0026amp;description=Qwen3.8-Max+Chat+Completions+API+%EB%A0%88%ED%8D%BC%EB%9F%B0%EC%8A%A4+%EB%B0%8F+%EC%8B%A4%EC%8B%9C%EA%B0%84+%ED%94%8C%EB%A0%88%EC%9D%B4%EA%B7%B8%EB%9D%BC%EC%9A%B4%EB%93%9C%3A+OpenAI+%ED%98%B8%ED%99%98+%ED%98%95%EC%8B%9D%EC%97%90+reasoning_effort+%EB%8B%A8%EA%B3%84%2C+%EC%8A%A4%ED%8A%B8%EB%A6%AC%EB%B0%8D%2C+%ED%95%A8%EC%88%98+%ED%98%B8%EC%B6%9C%2C+%EC%9D%B4%EB%AF%B8%EC%A7%80%2F%EB%8F%99%EC%98%81%EC%83%81+%EC%9E%85%EB%A0%A5%EC%9D%84+%EC%A7%80%EC%9B%90%ED%95%A9%EB%8B%88%EB%8B%A4.\u0026amp;theme=421dcf1ed22dd4b5d53fa3cb\u0026amp;signature=e37e5ffd34a78ac50f67c4f4b630f5f8173681a90e51223a36efde4952b4bd99\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/apiyillc/sQlsuRwD6o27XLvg/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"API易文档中心\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563eb\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.apiyi.com/ko/api-capabilities/qwen-3-8/chat-completions\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ko/api-capabilities/qwen-3-8/chat-completions.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.apiyi.com/ko/api-capabilities/qwen-3-8/chat-completions\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.apiyi.com/api-capabilities/qwen-3-8/chat-completions\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.apiyi.com/en/api-capabilities/qwen-3-8/chat-completions\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh-Hant\" href=\"https://docs.apiyi.com/zh-Hant/api-capabilities/qwen-3-8/chat-completions\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ja\" href=\"https://docs.apiyi.com/ja/api-capabilities/qwen-3-8/chat-completions\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ru\" href=\"https://docs.apiyi.com/ru/api-capabilities/qwen-3-8/chat-completions\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.apiyi.com/api-capabilities/qwen-3-8/chat-completions\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.apiyi.com/#organization\",\"name\":\"API易文档中心\",\"url\":\"https://docs.apiyi.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/apiyillc/LjCT1O0GrSur6F2v/logo/light.svg?fit=max\u0026auto=format\u0026n=LjCT1O0GrSur6F2v\u0026q=85\u0026s=4119ef17a74cc54be127f34578d8b5fa\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.apiyi.com#website\",\"name\":\"API易文档中心\",\"url\":\"https://docs.apiyi.com\",\"publisher\":{\"@id\":\"https://docs.apiyi.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.apiyi.com/ko/api-capabilities/qwen-3-8/chat-completions#webpage\",\"url\":\"https://docs.apiyi.com/ko/api-capabilities/qwen-3-8/chat-completions\",\"name\":\"Qwen3.8-Max Chat API 레퍼런스\",\"description\":\"Qwen3.8-Max Chat Completions API 레퍼런스 및 실시간 플레이그라운드: OpenAI 호환 형식에 reasoning_effort 단계, 스트리밍, 함수 호출, 이미지/동영상 입력을 지원합니다.\",\"dateModified\":\"2026-08-03T15:20:41.487Z\",\"isPartOf\":{\"@id\":\"https://docs.apiyi.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.apiyi.com/ko/api-capabilities/qwen-3-8/chat-completions#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.apiyi.com/ko/api-capabilities/qwen-3-8/chat-completions#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"텍스트 생성\",\"item\":\"https://docs.apiyi.com/ko/api-capabilities/text-generation\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Qwen3 시리즈\",\"item\":\"https://docs.apiyi.com/ko/api-capabilities/qwen-3-8/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Qwen3.8-Max Chat API 레퍼런스\",\"item\":\"https://docs.apiyi.com/ko/api-capabilities/qwen-3-8/chat-completions\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.apiyi.com/ko/api-capabilities/qwen-3-8/chat-completions#apireference\",\"headline\":\"Qwen3.8-Max Chat API 레퍼런스\",\"name\":\"Qwen3.8-Max Chat API 레퍼런스\",\"description\":\"Qwen3.8-Max Chat Completions API 레퍼런스 및 실시간 플레이그라운드: OpenAI 호환 형식에 reasoning_effort 단계, 스트리밍, 함수 호출, 이미지/동영상 입력을 지원합니다.\",\"url\":\"https://docs.apiyi.com/ko/api-capabilities/qwen-3-8/chat-completions\",\"mainEntityOfPage\":{\"@id\":\"https://docs.apiyi.com/ko/api-capabilities/qwen-3-8/chat-completions#webpage\"},\"dateModified\":\"2026-08-03T15:20:41.487Z\",\"publisher\":{\"@id\":\"https://docs.apiyi.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.apiyi.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"API易文档中心\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"API易文档中心","nav":{"global":{"anchors":[]},"languages":[{"language":"zh","pages":[{"title":"zh","href":"/api-capabilities/qwen-3-8/chat-completions"}]},{"language":"en","navbar":{"links":[{"href":"https://api.apiyi.com","label":"Home"},{"href":"https://imagen.apiyi.com","label":"AI Image"},{"href":"https://icover.ai","label":"AI Video"}],"primary":{"type":"button","label":"Console","href":"https://api.apiyi.com/account/profile"}},"pages":[{"title":"en","href":"/en/api-capabilities/qwen-3-8/chat-completions"}]},{"language":"zh-Hant","banner":{"content":"本頁由程式自動轉換為繁體中文,用詞以台灣正體為準;如有歧義請以[簡體中文版](/)為準。","dismissible":true},"footer":{"socials":{"website":"https://api.apiyi.com"},"links":[{"header":"AI 整合","items":[{"label":"skill.md","href":"https://docs.apiyi.com/skill.md"},{"label":"llms.txt","href":"https://docs.apiyi.com/llms.txt"},{"label":"llms-full.txt","href":"https://docs.apiyi.com/llms-full.txt"},{"label":"model-registry.json","href":"https://docs.apiyi.com/model-registry.json"},{"label":"AI 開發者套件(中文)","href":"/developer-kit"},{"label":"AI Developer Kit (EN)","href":"/en/developer-kit"}]},{"header":"使用者口碑 / Wall of Love","items":[{"label":"使用者口碑(中文)","href":"/wall-of-love"},{"label":"Wall of Love (EN)","href":"/en/wall-of-love"}]}]},"navbar":{"links":[{"href":"https://api.apiyi.com","label":"首頁"},{"href":"https://imagen.apiyi.com","label":"AI出圖"},{"href":"https://icover.ai","label":"AI影片"}],"primary":{"type":"button","label":"控制台","href":"https://api.apiyi.com/account/profile"}},"pages":[{"title":"zh-Hant","href":"/zh-Hant/api-capabilities/qwen-3-8/chat-completions"}]},{"language":"ja","banner":{"content":"このページは AI により翻訳されています。内容に相違がある場合は[English 版](/en)を正としてください。","dismissible":true},"footer":{"socials":{"website":"https://api.apiyi.com"},"links":[{"header":"AI統合","items":[{"label":"skill.md","href":"https://docs.apiyi.com/skill.md"},{"label":"llms.txt","href":"https://docs.apiyi.com/llms.txt"},{"label":"llms-full.txt","href":"https://docs.apiyi.com/llms-full.txt"},{"label":"model-registry.json","href":"https://docs.apiyi.com/model-registry.json"},{"label":"AI開発者キット(中国語)","href":"/developer-kit"},{"label":"AI Developer Kit (EN)","href":"/en/developer-kit"}]},{"header":"ユーザーの声 / Wall of Love","items":[{"label":"ユーザーの声(中国語)","href":"/wall-of-love"},{"label":"Wall of Love(英語)","href":"/en/wall-of-love"}]}]},"navbar":{"links":[{"href":"https://api.apiyi.com","label":"ホーム"},{"href":"https://imagen.apiyi.com","label":"AI画像生成"},{"href":"https://icover.ai","label":"AI動画生成"}],"primary":{"type":"button","label":"コンソール","href":"https://api.apiyi.com/account/profile"}},"pages":[{"title":"ja","href":"/ja/api-capabilities/qwen-3-8/chat-completions"}]},{"language":"ko","banner":{"content":"이 페이지는 AI로 번역되었습니다. 내용이 다를 경우 [English 버전](/en)을 기준으로 하십시오.","dismissible":true},"footer":{"socials":{"website":"https://api.apiyi.com"},"links":[{"header":"AI 통합","items":[{"label":"skill.md","href":"https://docs.apiyi.com/skill.md"},{"label":"llms.txt","href":"https://docs.apiyi.com/llms.txt"},{"label":"llms-full.txt","href":"https://docs.apiyi.com/llms-full.txt"},{"label":"model-registry.json","href":"https://docs.apiyi.com/model-registry.json"},{"label":"AI 개발자 키트(중국어)","href":"/developer-kit"},{"label":"AI Developer Kit (EN)","href":"/en/developer-kit"}]},{"header":"사용자 후기 / Wall of Love","items":[{"label":"사용자 후기(중국어)","href":"/wall-of-love"},{"label":"Wall of Love (영문)","href":"/en/wall-of-love"}]}]},"navbar":{"links":[{"href":"https://api.apiyi.com","label":"홈"},{"href":"https://imagen.apiyi.com","label":"AI 이미지 생성"},{"href":"https://icover.ai","label":"AI 동영상 생성"}],"primary":{"type":"button","label":"콘솔","href":"https://api.apiyi.com/account/profile"}},"tabs":[{"tab":"홈","icon":"house","groups":[{"group":"기초","pages":[{"title":"APIYI - AI 모델 API 허브","sidebarTitle":"소개","icon":"house","href":"/ko"},{"title":"빠른 시작","icon":"rocket","href":"/ko/getting-started"},{"group":"AI 개발자 키트","icon":"terminal","pages":[{"title":"AI 개발자 키트","sidebarTitle":"AI 개발자 키트","icon":"bot","href":"/ko/developer-kit"},{"title":"터미널에 apiyi 명령을 찾을 수 없다고 표시되는 이유는 무엇인가요?","icon":"terminal","href":"/ko/faq/apiyi-cli-command-not-found"}]},{"group":"API 매뉴얼","icon":"book","pages":[{"title":"API 매뉴얼","sidebarTitle":"매뉴얼 개요","icon":"book","href":"/ko/api-manual"},{"title":"API 오류 세부 정보 캡처","sidebarTitle":"오류 캡처","icon":"clipboard-list","href":"/ko/api-manual/error-reporting"},{"group":"API 연동 자주 묻는 질문","icon":"circle-question-mark","expanded":false,"pages":[{"title":"APIYI는 파일 API를 지원하나요?","icon":"file-up","href":"/ko/faq/files-api-not-supported"},{"title":"Base URL을 어떻게 설정하나요? /v1, 루트 도메인, /v1beta의 차이","icon":"link","href":"/ko/faq/base-url-config"},{"title":"모델 API 오류를 어떻게 해결할 수 있습니까?","icon":"alert-triangle","href":"/ko/faq/model-error-troubleshooting"},{"title":"API 동시 실행 수 제한은 무엇입니까?","icon":"gauge","href":"/ko/faq/api-concurrency"}]}]},{"title":"가격","icon":"badge-dollar-sign","href":"/ko/pricing"}]},{"group":"기본 API","icon":"box","pages":[{"group":"모델 정보","icon":"cpu","pages":[{"title":"인기 모델","icon":"database","href":"/ko/api-capabilities/model-info"},{"group":"모델 자주 묻는 질문","icon":"circle-question-mark","expanded":false,"pages":[{"title":"적합한 AI 모델을 선택하는 방법","icon":"compass","href":"/ko/faq/model-selection-guide"},{"title":"공식 웹 앱과 API가 서로 다른 결과를 내는 이유","icon":"layers","href":"/ko/faq/webapp-vs-api-difference"},{"title":"왜 AI 모델은 자신의 버전을 알지 못합니까?","icon":"circle-question-mark","href":"/ko/faq/model-version-identity"}]}]},{"title":"이미지 및 동영상 생성 모델","icon":"palette","href":"/ko/api-capabilities/image-video-models"},{"group":"OpenAI API 호출","icon":"sparkles","pages":[{"title":"OpenAI Responses API 네이티브 가이드","sidebarTitle":"네이티브 호출","icon":"zap","href":"/ko/api-capabilities/openai/native"},{"title":"OpenAI Chat Completions 호환 모드","sidebarTitle":"호환 모드","icon":"plug","href":"/ko/api-capabilities/openai/compatible"},{"title":"엔드포인트 선택: GPT-5.4+를 Responses로 마이그레이션하기","sidebarTitle":"엔드포인트 및 마이그레이션","icon":"route","href":"/ko/api-capabilities/openai/responses-migration"},{"title":"OpenAI 호환 모드: 응답 처리","sidebarTitle":"응답 처리","icon":"braces","href":"/ko/api-capabilities/openai/response-handling"},{"title":"OpenAI 호환 모드: 추론 모델 출력","sidebarTitle":"추론 모델 출력","icon":"brain","href":"/ko/api-capabilities/openai/reasoning-models"},{"title":"OpenAI 프롬프트 캐싱 과금 가이드","sidebarTitle":"캐시 과금","icon":"database","href":"/ko/api-capabilities/openai/prompt-caching"},{"title":"OpenAI Function Calling 가이드","sidebarTitle":"함수 호출","icon":"wrench","href":"/ko/api-capabilities/openai/function-calling"},{"title":"OpenAI API 웹 검색 가이드","sidebarTitle":"웹 검색","icon":"globe","href":"/ko/api-capabilities/openai/web-search"},{"group":"OpenAI 자주 묻는 질문","icon":"circle-question-mark","pages":[{"title":"APIYI는 OpenAI 빠름/초고속 모드를 지원하나요?","icon":"gauge","href":"/ko/faq/openai-service-tier-fast-mode"},{"title":"콘텐츠 필터링 시 스트리밍 요청과 비스트리밍 요청은 어떻게 다릅니까?","sidebarTitle":"스트리밍 및 콘텐츠 필터링","icon":"shield-half","href":"/ko/faq/streaming-content-filter"},{"title":"OpenAI 모델 거절 응답은 어떤 형태입니까?","icon":"message-square-x","href":"/ko/faq/openai-content-safety-refusal"}]}]},{"group":"Claude 공식","icon":"sparkles","pages":[{"title":"Claude API 호출 기본","sidebarTitle":"Claude API 기본","icon":"sparkles","href":"/ko/api-capabilities/claude"},{"title":"Claude 네이티브 형식: 스트리밍 및 비스트리밍 응답","sidebarTitle":"스트리밍 및 응답","icon":"braces","href":"/ko/api-capabilities/claude-response-handling"},{"title":"Claude 프롬프트 캐싱 가이드","sidebarTitle":"프롬프트 캐싱","icon":"database","href":"/ko/api-capabilities/claude-prompt-caching"},{"title":"Claude Effort \u0026 Thinking 가이드","sidebarTitle":"Effort \u0026 Thinking","icon":"gauge","href":"/ko/api-capabilities/claude-effort-thinking"},{"title":"Claude API 웹 검색 가이드","sidebarTitle":"Claude 웹 검색","icon":"globe","href":"/ko/api-capabilities/claude-web-search"},{"group":"Claude 자주 묻는 질문","icon":"circle-question-mark","pages":[{"title":"Claude가 Qwen이나 DeepSeek이라고 주장하는 이유","icon":"venetian-mask","href":"/ko/faq/claude-identity-confusion"},{"title":"Claude의 Invalid Thinking Signature 오류는 어떻게 해결합니까?","icon":"file-signature","href":"/ko/faq/claude-thinking-signature-invalid"},{"title":"Claude 거절 시 빈 콘텐츠가 반환되는 이유는 무엇입니까?","icon":"message-square-x","href":"/ko/faq/claude-content-safety-refusal"}]}]},{"group":"Gemini 네이티브 호출","icon":"sparkles","pages":[{"title":"Gemini 네이티브 형식 가이드","sidebarTitle":"네이티브 호출","icon":"zap","href":"/ko/api-capabilities/gemini/native"},{"title":"Interactions API 대 generateContent","sidebarTitle":"Interactions API 비교","icon":"git-compare","href":"/ko/api-capabilities/gemini/interactions-api"},{"title":"Gemini 네이티브 형식: 스트리밍 및 비스트리밍 응답","sidebarTitle":"스트리밍 및 응답","icon":"braces","href":"/ko/api-capabilities/gemini/response-handling"},{"title":"Gemini 멀티모달 입력 및 코드 실행","sidebarTitle":"멀티모달 및 코드 실행","icon":"images","href":"/ko/api-capabilities/gemini/multimodal"},{"title":"Gemini 암시적 캐싱 과금 가이드","sidebarTitle":"캐시 과금","icon":"database","href":"/ko/api-capabilities/gemini/prompt-caching"},{"title":"Gemini 함수 호출 가이드","sidebarTitle":"함수 호출","icon":"wrench","href":"/ko/api-capabilities/gemini/function-calling"},{"title":"Gemini API Web Search 가이드","sidebarTitle":"웹 검색","icon":"globe","href":"/ko/api-capabilities/gemini/web-search"},{"title":"Gemini 도구 호출 시 Thought Signature 400 오류를 해결하려면 어떻게 해야 하나요?","icon":"file-signature","href":"/ko/faq/gemini-thought-signature-missing"}]},{"group":"Grok API 호출","icon":"sparkles","pages":[{"title":"Grok 모델 시리즈 가이드","sidebarTitle":"Grok 개요","icon":"rocket","href":"/ko/api-capabilities/grok/overview"},{"title":"Grok 채팅 및 추론 가이드","sidebarTitle":"채팅 \u0026 추론","icon":"message-square","href":"/ko/api-capabilities/grok/chat"},{"title":"Grok 웹 검색 및 X 검색 가이드","sidebarTitle":"웹 및 X 검색","icon":"globe","href":"/ko/api-capabilities/grok/web-search"},{"title":"Grok 코드 실행 및 원격 MCP 가이드","sidebarTitle":"코드 실행 및 MCP","icon":"terminal","href":"/ko/api-capabilities/grok/code-execution-mcp"},{"title":"Grok 멀티 에이전트 모델 가이드","sidebarTitle":"멀티 에이전트 모델","icon":"users","href":"/ko/api-capabilities/grok/multi-agent"},{"title":"Grok 프롬프트 캐싱 과금 가이드","sidebarTitle":"캐시 과금","icon":"database","href":"/ko/api-capabilities/grok/prompt-caching"}]},{"group":"텍스트 API 모범 사례","icon":"book-check","pages":[{"title":"장문 출력 실무 가이드","sidebarTitle":"장문 출력","icon":"book-check","href":"/ko/api-capabilities/long-form-output-practices"},{"title":"다중 턴 대화 가이드","sidebarTitle":"다중 턴 대화","icon":"messages-square","href":"/ko/api-capabilities/multi-turn-conversation"},{"group":"텍스트 자주 묻는 질문","icon":"circle-question-mark","expanded":false,"pages":[{"title":"스트리밍 호출과 비스트리밍 호출의 차이점은 무엇입니까?","sidebarTitle":"스트리밍 vs 비스트리밍","icon":"audio-lines","href":"/ko/faq/streaming-vs-non-streaming"},{"title":"max_tokens란 무엇입니까? 설정하지 않으면 어떻게 됩니까?","icon":"sliders-horizontal","href":"/ko/faq/max-tokens"},{"title":"API에 ChatGPT 같은 메모리가 있나요?","icon":"brain","href":"/ko/faq/api-memory"}]}]},{"title":"잔액 조회 API","icon":"wallet","href":"/ko/api-capabilities/balance-query"},{"title":"로그 쿼리 API","icon":"file-text","href":"/ko/api-capabilities/log-query"},{"title":"Token 관리 API","icon":"key","href":"/ko/api-capabilities/token-management"},{"title":"지원 종료된 모델","icon":"triangle-alert","href":"/ko/api-capabilities/deprecated-models"}]},{"group":"이미지 API (공식)","icon":"image","pages":[{"group":"이미지 API 핵심","icon":"book-check","pages":[{"title":"이미지 API 필수 사항 및 모범 사례","sidebarTitle":"반드시 읽기 \u0026 모범 사례","icon":"book-check","href":"/ko/api-capabilities/image-api-best-practices"},{"title":"이미지 API 연결 끊김 문제 해결","sidebarTitle":"연결 끊김","icon":"unplug","href":"/ko/api-capabilities/image-connection-drops"},{"title":"데이터가 도착한 뒤에도 멈춰 있는 이미지 요청","sidebarTitle":"끝에서 멈추는 요청","icon":"hourglass","href":"/ko/api-capabilities/image-tail-stall"},{"title":"이미지 압축 및 출력 해상도","sidebarTitle":"압축 및 해상도","icon":"scaling","href":"/ko/api-capabilities/image-compression-resolution"},{"title":"만족스러운 이미지를 얻는 방법","sidebarTitle":"만족스러운 이미지 얻기","icon":"target","href":"/ko/api-capabilities/image-generation-success-tips"},{"title":"안전성 거부 문제 해결: 절제 실험으로 트리거 단어 찾기","sidebarTitle":"안전성 거부","icon":"shield-alert","href":"/ko/api-capabilities/image-safety-troubleshooting"},{"title":"긴 prompt와 2단계 생성: 32K 제한은 어디에서 비롯되는가","sidebarTitle":"긴 prompt","icon":"text-quote","href":"/ko/api-capabilities/image-long-prompt"},{"title":"고급 이미지 생성: 워크플로와 사실감","sidebarTitle":"고급 워크플로","icon":"workflow","href":"/ko/api-capabilities/image-advanced-workflow"},{"title":"이미지 Prompt Doctor 스킬","sidebarTitle":"Prompt Doctor 스킬","icon":"stethoscope","href":"/ko/api-capabilities/image-prompt-doctor"},{"group":"이미지 자주 묻는 질문","icon":"circle-question-mark","pages":[{"title":"텍스트와 생성된 이미지를 모두 출력하는 대화형 API가 있습니까?","sidebarTitle":"하나의 API에서 텍스트 + 이미지","icon":"images","href":"/ko/faq/text-and-image-in-one-api"},{"title":"이미지 요청이 결과 없이 멈추지만 로그에 쓰기 실패가 표시되나요?","icon":"hourglass","href":"/ko/faq/image-direct-large-response-stall"},{"title":"프록시 환경에서 이미지 호출이 약 90초 후 끊기나요?","icon":"unplug","href":"/ko/faq/proxy-idle-timeout-disconnect"},{"title":"생성된 이미지가 참조 이미지와 크게 다른 이유는 무엇입니까?","icon":"image","href":"/ko/faq/image-result-differs-from-reference"},{"title":"이미지 콘텐츠가 MIME 유형과 일치하지 않는 오류를 해결하는 방법은 무엇입니까?","icon":"image","href":"/ko/faq/image-mime-type-mismatch-with-query"},{"title":"비동기 이미지 API가 있나요? 결과를 태스크 ID로 조회할 수 있나요?","icon":"image","href":"/ko/faq/image-async-api"}]}]},{"group":"GPT-Image-2.5 / 2 이미지 생성","icon":"sparkles","pages":[{"title":"GPT-Image-2.5 / 2 이미지 생성/편집","sidebarTitle":"GPT-Image-2.5 / 2 개요","icon":"sparkles","href":"/ko/api-capabilities/gpt-image-2/overview"},{"title":"텍스트-이미지 API 레퍼런스","openapi":"api-reference/gpt-image-2-generate-openapi-en.yaml POST /v1/images/generations","icon":"wand-sparkles","href":"/ko/api-capabilities/gpt-image-2/text-to-image"},{"title":"이미지 편집 API 레퍼런스","openapi":"api-reference/gpt-image-2-edit-openapi-en.yaml POST /v1/images/edits","icon":"image","href":"/ko/api-capabilities/gpt-image-2/image-edit"},{"title":"GPT-Image-2.5 / 2 시리즈 에이전트 스킬","icon":"blocks","href":"/ko/api-capabilities/gpt-image-2/skills"},{"title":"마스크 인페인팅 가이드","sidebarTitle":"마스크 인페인팅","icon":"brush","href":"/ko/api-capabilities/gpt-image-2/mask-editing"},{"title":"GPT-Image 레거시 버전","sidebarTitle":"GPT-Image 레거시","icon":"rotate-ccw-clock","href":"/ko/api-capabilities/gpt-image-2/historical-versions"},{"group":"GPT-Image 자주 묻는 질문","icon":"circle-question-mark","pages":[{"title":"투명 배경 이미지(PNG 누끼)는 어떻게 생성하나요?","icon":"layers","href":"/ko/faq/image-transparent-background"},{"title":"GPT 이미지 출력 token 수가 왜 이렇게 높은가요?","icon":"calculator","href":"/ko/faq/gpt-image-output-token-calculation"},{"title":"잘못된 API 키로 인해 GPT-Image용 Codex 통합 실패","sidebarTitle":"OpenAI에서 이미지 키 거부","icon":"key-round","href":"/ko/faq/gpt-image-incorrect-api-key-openai"}]}]},{"title":"GPT-image-2.5 / 2 공식 버전 vs 리버스 버전","sidebarTitle":"GPT-image-2.5 / 2 공식 버전 vs 리버스 버전","icon":"scale","href":"/ko/api-capabilities/gpt-image-2/vs-gpt-image-2-all"},{"group":"GPT-Image-2.5-All 이미지 생성","icon":"sparkles","pages":[{"title":"GPT-이미지-2.5-All 이미지 생성/편집","sidebarTitle":"GPT-이미지-2.5-All 개요","icon":"sparkles","href":"/ko/api-capabilities/gpt-image-2-all/overview"},{"title":"텍스트 투 이미지 API 레퍼런스","openapi":"api-reference/gpt-image-2-all-generate-openapi-en.yaml POST /v1/images/generations","icon":"wand-sparkles","href":"/ko/api-capabilities/gpt-image-2-all/text-to-image"},{"title":"이미지 편집 API 레퍼런스","openapi":"api-reference/gpt-image-2-all-edit-openapi-en.yaml POST /v1/images/edits","icon":"image","href":"/ko/api-capabilities/gpt-image-2-all/image-edit"},{"title":"GPT-Image-2.5-All Agent 스킬","icon":"blocks","href":"/ko/api-capabilities/gpt-image-2-all/skills"}]},{"group":"GPT-Image-2.5-VIP 이미지 생성","icon":"expand","pages":[{"title":"GPT-Image-2.5-VIP 이미지 생성/편집","sidebarTitle":"GPT-Image-2.5-VIP 개요","icon":"expand","href":"/ko/api-capabilities/gpt-image-2-vip/overview"},{"title":"텍스트-이미지 API 레퍼런스","openapi":"api-reference/gpt-image-2-vip-generate-openapi-en.yaml POST /v1/images/generations","icon":"wand-sparkles","href":"/ko/api-capabilities/gpt-image-2-vip/text-to-image"},{"title":"이미지 편집 API 레퍼런스","openapi":"api-reference/gpt-image-2-vip-edit-openapi-en.yaml POST /v1/images/edits","icon":"image","href":"/ko/api-capabilities/gpt-image-2-vip/image-edit"},{"title":"GPT-Image-2.5-VIP 에이전트 스킬","icon":"blocks","href":"/ko/api-capabilities/gpt-image-2-vip/skills"}]},{"title":"Nano Banana 시리즈 요금 안내","icon":"tag","href":"/ko/api-capabilities/nano-banana-pricing"},{"group":"NanoBanana 모범 사례","icon":"lightbulb","pages":[{"title":"Nano Banana 시리즈 개발자 가이드","icon":"compass","href":"/ko/api-capabilities/nano-banana-dev-guide"},{"title":"사용 필드 및 출력 설명","sidebarTitle":"사용 필드 및 출력 설명","icon":"receipt-text","href":"/ko/api-capabilities/nano-banana-usage-metadata"},{"title":"Gemini 이미지 생성 API 오류 처리 가이드","icon":"triangle-alert","href":"/ko/api-capabilities/gemini-image-error-handling"},{"title":"다중 이미지 융합 테스트 가이드","sidebarTitle":"다중 이미지 융합 테스트","icon":"layers","href":"/ko/api-capabilities/multi-image-fusion-testing"},{"title":"Nano Banana Pro 실패 생성 크레딧 환불 계획","icon":"shield-check","href":"/ko/api-capabilities/nano-banana-pro-guarantee"},{"title":"Nano Banana OSS 그룹","icon":"link","href":"/ko/api-capabilities/nano-banana-oss-group"},{"group":"NB 자주 묻는 질문","icon":"circle-question-mark","pages":[{"title":"Google 모델은 AI Studio에서 실행됩니까, 아니면 Vertex에서 실행됩니까?","icon":"split","href":"/ko/faq/google-upstream-aistudio-vertex"},{"title":"이미지 편집 시 Unable to Process Input Image가 반환되나요?","icon":"image-off","href":"/ko/faq/gemini-empty-inlinedata"},{"title":"Gemini 이미지가 IMAGE_OTHER를 반환하는 이유","sidebarTitle":"IMAGE_OTHER","icon":"image-minus","href":"/ko/faq/gemini-image-other"},{"title":"Gemini 이미지에서 blockReason: OTHER가 반환되는 이유는 무엇입니까?","sidebarTitle":"blockReason: OTHER","icon":"shield-alert","href":"/ko/faq/gemini-image-input-blocked"},{"title":"Nano Banana 이미지 생성 실패의 일반적인 원인","icon":"image-off","href":"/ko/faq/nano-banana-image-failure"},{"title":"Gemini 이미지 API가 NO_IMAGE를 반환하는 이유는 무엇입니까?","icon":"image-off","href":"/ko/faq/gemini-no-image"},{"title":"Nano Banana Pro로 편집한 후 내 이미지가 왜 붉은빛을 띠나요?","icon":"image","href":"/ko/faq/banana-pro-edit-red-cast"},{"title":"Nano Banana Pro에서 의상을 바꿀 때 인쇄 무늬가 왜곡되는 문제를 어떻게 해결하나요?","icon":"shirt","href":"/ko/faq/nano-banana-pro-print-distortion"},{"title":"왜 흰 배경 이미지에 검은 점, 더러운 얼룩, 또는 흐릿한 색 블록이 나타납니까?","icon":"triangle-alert","href":"/ko/faq/white-background-image-artifacts"}]}]},{"group":"Nano Banana 2.1 이미지 생성","icon":"banana","pages":[{"title":"Nano Banana 2.1 이미지 생성/편집","icon":"banana","href":"/ko/api-capabilities/gemini-nano-banana-2.1/overview"},{"title":"텍스트 투 이미지 API 레퍼런스","openapi":"api-reference/gemini-nano-banana-2.1-generate-openapi-en.yaml POST /v1beta/models/gemini-nano-banana-2.1:generateContent","icon":"wand-sparkles","href":"/ko/api-capabilities/gemini-nano-banana-2.1/text-to-image"},{"title":"이미지 편집 API 레퍼런스","openapi":"api-reference/gemini-nano-banana-2.1-edit-openapi-en.yaml POST /v1beta/models/gemini-nano-banana-2.1:generateContent","icon":"image","href":"/ko/api-capabilities/gemini-nano-banana-2.1/image-edit"},{"title":"Nano Banana 2.1 에이전트 스킬","icon":"blocks","href":"/ko/api-capabilities/gemini-nano-banana-2.1/skills"}]},{"group":"Nano Banana Pro 이미지 생성","icon":"banana","pages":[{"title":"Nano Banana Pro 이미지 생성","icon":"banana","href":"/ko/api-capabilities/nano-banana-image/overview"},{"title":"텍스트-이미지 API 레퍼런스","openapi":"api-reference/nano-banana-pro-generate-openapi-en.yaml POST /v1beta/models/gemini-3-pro-image:generateContent","icon":"wand-sparkles","href":"/ko/api-capabilities/nano-banana-image/text-to-image"},{"title":"이미지 편집 API 참조","openapi":"api-reference/nano-banana-pro-edit-openapi-en.yaml POST /v1beta/models/gemini-3-pro-image:generateContent","icon":"image","href":"/ko/api-capabilities/nano-banana-image/image-edit"},{"title":"Nano Banana Pro Agent Skill","icon":"blocks","href":"/ko/api-capabilities/nano-banana-image/skills"}]},{"group":"Nano Banana 2 이미지 생성","icon":"banana","pages":[{"title":"Nano Banana 2 이미지 생성/편집","icon":"banana","href":"/ko/api-capabilities/nano-banana-2-image/overview"},{"title":"텍스트-이미지 API 레퍼런스","openapi":"api-reference/nano-banana-2-generate-openapi-en.yaml POST /v1beta/models/gemini-3.1-flash-image:generateContent","icon":"wand-sparkles","href":"/ko/api-capabilities/nano-banana-2-image/text-to-image"},{"title":"이미지 편집 API 참조","openapi":"api-reference/nano-banana-2-edit-openapi-en.yaml POST /v1beta/models/gemini-3.1-flash-image:generateContent","icon":"image","href":"/ko/api-capabilities/nano-banana-2-image/image-edit"},{"title":"Nano Banana 2 에이전트 스킬","icon":"blocks","href":"/ko/api-capabilities/nano-banana-2-image/skills"}]},{"group":"Nano Banana Lite 이미지 생성","icon":"banana","pages":[{"title":"Nano Banana Lite 이미지 생성/편집","icon":"banana","href":"/ko/api-capabilities/nano-banana-lite-image/overview"},{"title":"텍스트-이미지 API 레퍼런스","openapi":"api-reference/nano-banana-lite-generate-openapi-en.yaml POST /v1beta/models/gemini-3.1-flash-lite-image:generateContent","icon":"wand-sparkles","href":"/ko/api-capabilities/nano-banana-lite-image/text-to-image"},{"title":"이미지 편집 API 레퍼런스","openapi":"api-reference/nano-banana-lite-edit-openapi-en.yaml POST /v1beta/models/gemini-3.1-flash-lite-image:generateContent","icon":"image","href":"/ko/api-capabilities/nano-banana-lite-image/image-edit"},{"title":"Nano Banana Lite 에이전트 스킬","icon":"blocks","href":"/ko/api-capabilities/nano-banana-lite-image/skills"}]},{"group":"FLUX 이미지 생성 및 편집","icon":"sparkles","pages":[{"title":"FLUX 이미지 생성 및 편집","sidebarTitle":"FLUX 개요","icon":"sparkles","href":"/ko/api-capabilities/flux/overview"},{"title":"텍스트-투-이미지 API 레퍼런스","openapi":"api-reference/flux-generate-openapi-en.yaml POST /v1/images/generations","icon":"wand-sparkles","href":"/ko/api-capabilities/flux/text-to-image"},{"title":"이미지 편집 API Reference","openapi":"api-reference/flux-edit-openapi-en.yaml POST /v1/images/generations","icon":"image","href":"/ko/api-capabilities/flux/image-edit"},{"title":"FLUX 과거 버전","sidebarTitle":"과거 버전","icon":"rotate-ccw-clock","href":"/ko/api-capabilities/flux/historical-versions"}]},{"group":"Seedream 5.0 시리즈","icon":"sparkles","pages":[{"title":"Seedream 이미지 생성 및 편집","sidebarTitle":"Seedream 개요","icon":"sparkles","href":"/ko/api-capabilities/seedream-image/overview"},{"title":"텍스트 투 이미지 API 레퍼런스","openapi":"api-reference/seedream-image-generate-openapi-en.yaml POST /v1/images/generations","icon":"wand-sparkles","href":"/ko/api-capabilities/seedream-image/text-to-image"},{"title":"이미지 편집 API 레퍼런스","openapi":"api-reference/seedream-image-edit-openapi-en.yaml POST /v1/images/generations","icon":"image","href":"/ko/api-capabilities/seedream-image/image-edit"},{"title":"Seedream 역대 버전","sidebarTitle":"역대 버전","icon":"rotate-ccw-clock","href":"/ko/api-capabilities/seedream-image/historical-versions"}]},{"group":"Grok Imagine 공식 이미지 생성","icon":"sparkles","pages":[{"title":"Grok Imagine 공식 이미지 생성","sidebarTitle":"Grok Imagine 공식 개요","icon":"sparkles","href":"/ko/api-capabilities/grok-imagine-image-official/overview"},{"title":"Grok Imagine 공식 텍스트 투 이미지 API 레퍼런스","sidebarTitle":"텍스트 투 이미지","openapi":"api-reference/grok-imagine-image-official-generate-openapi-en.yaml POST /v1/images/generations","icon":"wand-sparkles","href":"/ko/api-capabilities/grok-imagine-image-official/text-to-image"}]},{"group":"Grok Imagine 리버스 이미지 생성 및 편집","icon":"sparkles","pages":[{"title":"Grok Imagine Reverse 이미지 생성 및 편집","sidebarTitle":"Grok Imagine Reverse 개요","icon":"sparkles","href":"/ko/api-capabilities/grok-imagine-image/overview"},{"title":"텍스트-이미지 API 레퍼런스","openapi":"api-reference/grok-imagine-image-generate-openapi-en.yaml POST /v1/images/generations","icon":"wand-sparkles","href":"/ko/api-capabilities/grok-imagine-image/text-to-image"},{"title":"이미지 편집 API 레퍼런스","openapi":"api-reference/grok-imagine-image-edit-openapi-en.yaml POST /v1/images/edits","icon":"image","href":"/ko/api-capabilities/grok-imagine-image/image-edit"}]},{"group":"MAI-Image 2.6 이미지 생성 및 편집","icon":"sparkles","pages":[{"title":"MAI-Image 2.6 이미지 생성 및 편집","sidebarTitle":"MAI-Image 2.6 개요","icon":"sparkles","href":"/ko/api-capabilities/mai-image/overview"},{"title":"Text-to-Image API 레퍼런스","openapi":"api-reference/mai-image-generate-openapi-en.yaml POST /v1/images/generations","icon":"wand-sparkles","href":"/ko/api-capabilities/mai-image/text-to-image"},{"title":"이미지 편집 API 레퍼런스","openapi":"api-reference/mai-image-edit-openapi-en.yaml POST /v1/images/edits","icon":"image","href":"/ko/api-capabilities/mai-image/image-edit"}]},{"title":"이미지 API 통합 실전: 자체 비동기 큐 구축하기","sidebarTitle":"자가 호스팅 비동기 큐","icon":"list-checks","href":"/ko/api-capabilities/image-async-queue"}]},{"group":"동영상 API (공식)","icon":"video","pages":[{"group":"Seedance 2.0 / 2.5 (Volcengine)","icon":"film","pages":[{"title":"Seedance 2.0 / 2.5 동영상 생성","sidebarTitle":"Seedance 2.0 / 2.5 개요","icon":"film","href":"/ko/api-capabilities/seedance2/overview"},{"title":"Seedance 2.0 / 2.5 동영상 생성 API 참조","sidebarTitle":"동영상 생성","openapi":"api-reference/seedance2-video-openapi-en.yaml POST /seedance/api/v3/contents/generations/tasks","icon":"video","href":"/ko/api-capabilities/seedance2/video-generation"},{"title":"Seedance 2.0 동영상 에이전트 스킬","icon":"blocks","href":"/ko/api-capabilities/seedance2/skills"},{"title":"Seedance 2.0 에셋 라이브러리 (캐릭터 일관성 동영상)","sidebarTitle":"에셋 라이브러리","icon":"images","href":"/ko/api-capabilities/seedance2/asset-library"},{"title":"코드에서 에셋 참조 동영상 생성","sidebarTitle":"에셋 참조 가이드","icon":"clapperboard","href":"/ko/api-capabilities/seedance2/asset-reference"},{"title":"에셋 우선: 더 빠르고 안정적인 이미지 및 동영상 입력","sidebarTitle":"에셋 우선 워크플로","icon":"gauge","href":"/ko/api-capabilities/seedance2/asset-first-workflow"},{"group":"SD 자주 묻는 질문","icon":"circle-question-mark","pages":[{"title":"Seedance에서 첫 번째/마지막 프레임과 참조 미디어를 혼용할 수 없다고 표시되는 경우","sidebarTitle":"첫 번째 프레임과 참조 미디어 혼용","icon":"layers","href":"/ko/faq/seedance-first-frame-mixed-with-reference"},{"title":"Seedance에서 invalid image format 오류가 발생하지만 브라우저에서는 링크가 열리는 경우","sidebarTitle":"이미지 링크는 열리지만 실패하는 경우","icon":"link","href":"/ko/faq/seedance-image-url-invalid-format"},{"title":"Seedance 2.5: 참조-동영상 생성과 동영상 편집 비교","icon":"split","href":"/ko/faq/seedance2-reference-vs-edit"},{"title":"제출 후 Seedance 동영상 작업을 취소할 수 있나요?","icon":"video","href":"/ko/faq/seedance-video-task-cancel"},{"title":"task_id로 Seedance 동영상의 실제 비용을 조회하려면 어떻게 해야 하나요?","icon":"receipt","href":"/ko/faq/seedance-task-cost-lookup"},{"title":"Seedance 2.0이 얼굴 참조 이미지를 에셋 라이브러리에 자동 업로드합니까? 딥페이크 필터를 트리거합니까?","icon":"banana","href":"/ko/faq/seedance2-asset-face-reference"},{"title":"Seedance 2.0 / 2.5에서 얼굴 자산이 차단되는 이유","icon":"scan-face","href":"/ko/faq/seedance2-face-asset-whitelist"}]}]},{"group":"Wan3.0 동영상 생성 (Alibaba)","icon":"video","pages":[{"title":"Wan3.0 동영상 생성 (Alibaba Tongyi Wanxiang)","sidebarTitle":"개요","icon":"video","href":"/ko/api-capabilities/wan3/overview"},{"title":"Wan3.0 동영상 생성 API 레퍼런스","sidebarTitle":"동영상 생성","openapi":"api-reference/wan3-video-openapi-en.yaml POST /wan/api/v1/services/aigc/video-generation/video-synthesis","icon":"wand-sparkles","href":"/ko/api-capabilities/wan3/video-generation"}]},{"group":"Wan2.7 동영상 생성 (Alibaba)","icon":"videotape","pages":[{"title":"Wan 동영상 생성 (Alibaba Cloud Tongyi Wanxiang)","sidebarTitle":"Wan 개요","icon":"video","href":"/ko/api-capabilities/wan/overview"},{"title":"Wan2.7 텍스트-투-비디오 API 레퍼런스","sidebarTitle":"텍스트-투-비디오","openapi":"api-reference/wan-text-to-video-openapi-en.yaml POST /wan/api/v1/services/aigc/video-generation/video-synthesis","icon":"wand-sparkles","href":"/ko/api-capabilities/wan/text-to-video"},{"title":"Wan2.7 Image-to-Video API 레퍼런스","sidebarTitle":"Image-to-Video","openapi":"api-reference/wan-image-to-video-openapi-en.yaml POST /wan/api/v1/services/aigc/video-generation/video-synthesis","icon":"image","href":"/ko/api-capabilities/wan/image-to-video"},{"title":"Wan2.7 Reference-to-Video API 참조","sidebarTitle":"Reference-to-Video","openapi":"api-reference/wan-reference-to-video-openapi-en.yaml POST /wan/api/v1/services/aigc/video-generation/video-synthesis","icon":"users","href":"/ko/api-capabilities/wan/reference-to-video"},{"title":"Wan2.7 동영상 편집 API 레퍼런스","sidebarTitle":"동영상 편집","openapi":"api-reference/wan-video-edit-openapi-en.yaml POST /wan/api/v1/services/aigc/video-generation/video-synthesis","icon":"scissors","href":"/ko/api-capabilities/wan/video-edit"},{"title":"Wan2.7 및 HappyHorse 동영상 에이전트 스킬","icon":"blocks","href":"/ko/api-capabilities/wan/skills"},{"title":"Wan Historical Versions (Wan2.6)","sidebarTitle":"이전 버전","icon":"rotate-ccw-clock","href":"/ko/api-capabilities/wan/historical-versions"}]},{"group":"HappyHorse 동영상 생성 (Alibaba)","icon":"monitor-play","pages":[{"title":"HappyHorse 동영상 생성 (알리바바 클라우드)","sidebarTitle":"HappyHorse 개요","icon":"monitor-play","href":"/ko/api-capabilities/happyhorse/overview"},{"title":"HappyHorse 텍스트-투-비디오 API 레퍼런스","sidebarTitle":"텍스트-투-비디오","openapi":"api-reference/happyhorse-text-to-video-openapi-en.yaml POST /wan/api/v1/services/aigc/video-generation/video-synthesis","icon":"wand-sparkles","href":"/ko/api-capabilities/happyhorse/text-to-video"},{"title":"HappyHorse 이미지-to-동영상 API 레퍼런스","sidebarTitle":"이미지-to-동영상","openapi":"api-reference/happyhorse-image-to-video-openapi-en.yaml POST /wan/api/v1/services/aigc/video-generation/video-synthesis","icon":"image","href":"/ko/api-capabilities/happyhorse/image-to-video"},{"title":"HappyHorse 레퍼런스-투-비디오 API 레퍼런스","sidebarTitle":"레퍼런스-투-비디오","openapi":"api-reference/happyhorse-reference-to-video-openapi-en.yaml POST /wan/api/v1/services/aigc/video-generation/video-synthesis","icon":"users","href":"/ko/api-capabilities/happyhorse/reference-to-video"},{"title":"HappyHorse 비디오 편집 API 레퍼런스","sidebarTitle":"비디오 편집","openapi":"api-reference/happyhorse-video-edit-openapi-en.yaml POST /wan/api/v1/services/aigc/video-generation/video-synthesis","icon":"scissors","href":"/ko/api-capabilities/happyhorse/video-edit"},{"title":"HappyHorse 동영상 에이전트 스킬","icon":"blocks","href":"/ko/api-capabilities/happyhorse/skills"}]},{"group":"VEO 3.1 (Google)","icon":"clapperboard","pages":[{"title":"VEO 3.1 공식 동영상 생성","sidebarTitle":"VEO 3.1 공식 개요","icon":"video","href":"/ko/api-capabilities/veo-3-1-official/overview"},{"title":"VEO 3.1 공식 텍스트-투-비디오 API","sidebarTitle":"텍스트-투-비디오","openapi":"api-reference/veo-3-1-official-text-to-video-openapi-en.yaml POST /v1/videos","icon":"wand-sparkles","href":"/ko/api-capabilities/veo-3-1-official/text-to-video"},{"title":"VEO 3.1 공식 이미지-투-동영상 API","sidebarTitle":"이미지-투-동영상","openapi":"api-reference/veo-3-1-official-image-to-video-openapi-en.yaml POST /v1/videos","icon":"image","href":"/ko/api-capabilities/veo-3-1-official/image-to-video"},{"title":"VEO 3.1 공식 vs 역방향 채널 비교","sidebarTitle":"공식 vs 역방향","icon":"scale","href":"/ko/api-capabilities/veo-3-1-official/vs-veo-reverse"}]},{"group":"Grok Imagine 동영상 생성 (xAI)","icon":"camera","pages":[{"title":"Grok Imagine 동영상 생성","sidebarTitle":"Grok Imagine 동영상 개요","icon":"video","href":"/ko/api-capabilities/grok-imagine-video/overview"},{"title":"Grok Imagine 동영상 생성 API 레퍼런스","sidebarTitle":"동영상 생성","openapi":"api-reference/grok-imagine-video-openapi-en.yaml POST /v1/videos","icon":"wand-sparkles","href":"/ko/api-capabilities/grok-imagine-video/video-generation"}]},{"group":"MiniMax H3 동영상 생성 (자체 호스팅)","icon":"film","pages":[{"title":"MiniMax-H3 동영상 생성","sidebarTitle":"MiniMax-H3 개요","icon":"video","href":"/ko/api-capabilities/minimax-h3/overview"},{"title":"MiniMax-H3 동영상 생성 API 레퍼런스","sidebarTitle":"동영상 생성","openapi":"api-reference/minimax-h3-video-openapi-en.yaml POST /hailuo/v2/video_generation","icon":"video","href":"/ko/api-capabilities/minimax-h3/video-generation"}]},{"group":"Oxygen 동영상 생성 (AZ8)","icon":"clapperboard","pages":[{"title":"Oxygen 동영상 생성","sidebarTitle":"Oxygen 개요","icon":"video","href":"/ko/api-capabilities/oxygen/overview"},{"title":"Oxygen 동영상 생성 API 레퍼런스","sidebarTitle":"동영상 생성","openapi":"api-reference/oxygen-video-openapi-en.yaml POST /videos","icon":"video","href":"/ko/api-capabilities/oxygen/video-generation"}]}]},{"group":"멀티모달 이해 API","icon":"eye","pages":[{"title":"비전 이해(이미지 인식) API","icon":"eye","href":"/ko/api-capabilities/vision-understanding"},{"title":"동영상 이해 API","icon":"video","href":"/ko/api-capabilities/video-understanding"},{"title":"이미지 이해 요청이 계속 시간 초과됩니다 — 이미지가 너무 큰가요?","icon":"image","href":"/ko/faq/vision-image-too-large"}]},{"group":"텍스트 생성","icon":"file-text","pages":[{"title":"텍스트 생성 (Chat Completions)","icon":"message-square","href":"/ko/api-capabilities/text-generation"},{"group":"Gemini 4 Argon","icon":"sparkles","pages":[{"title":"Gemini 4 Argon 텍스트 생성","sidebarTitle":"Gemini 4 Argon 개요","icon":"sparkles","href":"/ko/api-capabilities/gemini-4-argon/overview"}]},{"group":"GPT-6 Astra","icon":"sparkles","pages":[{"title":"GPT-6 Astra 텍스트 생성","sidebarTitle":"GPT-6 Astra 개요","icon":"sparkles","href":"/ko/api-capabilities/gpt-6-astra/overview"}]},{"group":"DeepSeek V4 Flash Vision","icon":"eye","pages":[{"title":"DeepSeek V4 Flash 비전","sidebarTitle":"개요","icon":"eye","href":"/ko/api-capabilities/deepseek-v4-flash-vision/overview"},{"title":"DeepSeek V4 Flash Vision Chat API 레퍼런스","sidebarTitle":"Chat 플레이그라운드","openapi":"api-reference/deepseek-v4-flash-vision-chat-openapi-en.yaml POST /v1/chat/completions","icon":"terminal","href":"/ko/api-capabilities/deepseek-v4-flash-vision/chat-completions"},{"title":"DeepSeek V4 Flash Vision Messages API 참조","sidebarTitle":"메시지 플레이그라운드","openapi":"api-reference/deepseek-v4-flash-vision-messages-openapi-en.yaml POST /v1/messages","icon":"terminal","href":"/ko/api-capabilities/deepseek-v4-flash-vision/messages"}]},{"group":"DeepSeek V4 Flash","icon":"zap","pages":[{"title":"DeepSeek V4 Flash 텍스트 생성","sidebarTitle":"개요","icon":"zap","href":"/ko/api-capabilities/deepseek-v4-flash/overview"},{"title":"DeepSeek V4 Flash Chat API 레퍼런스","sidebarTitle":"Chat 플레이그라운드","openapi":"api-reference/deepseek-v4-flash-chat-openapi-en.yaml POST /v1/chat/completions","icon":"terminal","href":"/ko/api-capabilities/deepseek-v4-flash/chat-completions"},{"title":"DeepSeek V4 Flash Responses API 참고서","sidebarTitle":"Responses Playground","openapi":"api-reference/deepseek-v4-flash-responses-openapi-en.yaml POST /v1/responses","icon":"git-fork","href":"/ko/api-capabilities/deepseek-v4-flash/responses"}]},{"group":"DeepSeek Search \u0026 Fetch","icon":"search","pages":[{"title":"DeepSeek 웹 검색 및 가져오기 API","sidebarTitle":"개요","icon":"search","href":"/ko/api-capabilities/deepseek-search-fetch/overview"},{"title":"DeepSeek 웹 검색 API 레퍼런스","sidebarTitle":"검색 플레이그라운드","openapi":"api-reference/deepseek-search-openapi-en.yaml POST /v1/tools/search","icon":"terminal","href":"/ko/api-capabilities/deepseek-search-fetch/search-api"},{"title":"DeepSeek 웹 페이지 가져오기 API 레퍼런스","sidebarTitle":"가져오기 플레이그라운드","openapi":"api-reference/deepseek-fetch-openapi-en.yaml POST /v1/tools/fetch","icon":"terminal","href":"/ko/api-capabilities/deepseek-search-fetch/fetch-api"}]},{"group":"Seed 2.1 Turbo","icon":"zap","pages":[{"title":"Seed 2.1 Turbo 텍스트 생성","sidebarTitle":"개요","icon":"message-square","href":"/ko/api-capabilities/dola-seed-2-1-turbo/overview"},{"title":"Seed 2.1 Turbo 채팅 API 레퍼런스","sidebarTitle":"채팅 플레이그라운드","openapi":"api-reference/dola-seed-2-1-turbo-chat-openapi-en.yaml POST /v1/chat/completions","icon":"terminal","href":"/ko/api-capabilities/dola-seed-2-1-turbo/chat-completions"},{"title":"Seed 2.1 Turbo Responses API 레퍼런스","sidebarTitle":"Responses 플레이그라운드","openapi":"api-reference/dola-seed-2-1-turbo-responses-openapi-en.yaml POST /v1/responses","icon":"messages-square","href":"/ko/api-capabilities/dola-seed-2-1-turbo/responses"}]},{"group":"Gemini Flash 시리즈","icon":"sparkles","pages":[{"title":"Gemini 3.8 Flash 텍스트 생성","sidebarTitle":"Gemini 3.8 Flash 개요","icon":"sparkles","href":"/ko/api-capabilities/gemini-3-8-flash/overview"},{"title":"Gemini 3.6 Flash 텍스트 생성","sidebarTitle":"Gemini 3.6 Flash 개요","icon":"sparkles","href":"/ko/api-capabilities/gemini-3-6-flash/overview"},{"title":"Gemini 3.6 Flash 네이티브 API 참조","sidebarTitle":"3.6 네이티브 플레이그라운드","openapi":"api-reference/gemini-3-6-flash-native-openapi-en.yaml POST /v1beta/models/gemini-3.6-flash:generateContent","icon":"terminal","href":"/ko/api-capabilities/gemini-3-6-flash/generate-content"},{"title":"Gemini 3.6 Flash 채팅 API 레퍼런스","sidebarTitle":"3.6 채팅 플레이그라운드","openapi":"api-reference/gemini-3-6-flash-chat-openapi-en.yaml POST /v1/chat/completions","icon":"terminal","href":"/ko/api-capabilities/gemini-3-6-flash/chat-completions"}]},{"group":"Gemini 3.5 Flash-Lite","icon":"feather","pages":[{"title":"Gemini 3.5 Flash-Lite 텍스트 생성","sidebarTitle":"개요","icon":"feather","href":"/ko/api-capabilities/gemini-3-5-flash-lite/overview"},{"title":"Gemini 3.5 Flash-Lite 네이티브 API 레퍼런스","sidebarTitle":"네이티브 플레이그라운드","openapi":"api-reference/gemini-3-5-flash-lite-native-openapi-en.yaml POST /v1beta/models/gemini-3.5-flash-lite:generateContent","icon":"terminal","href":"/ko/api-capabilities/gemini-3-5-flash-lite/generate-content"},{"title":"Gemini 3.5 Flash-Lite Chat API 레퍼런스","sidebarTitle":"Chat 플레이그라운드","openapi":"api-reference/gemini-3-5-flash-lite-chat-openapi-en.yaml POST /v1/chat/completions","icon":"terminal","href":"/ko/api-capabilities/gemini-3-5-flash-lite/chat-completions"}]},{"group":"Qwen3 시리즈","icon":"puzzle","pages":[{"title":"Qwen3.8-Max 텍스트 생성","sidebarTitle":"개요","description":"Alibaba Qwen의 플래그십 Qwen3.8-Max: 2.4T-파라미터 희소 MoE, 1M 컨텍스트, 131K 출력, 네이티브 이미지 및 동영상 입력을 지원합니다. APIYI에 1M tokens당 $1.65/$4.95로 등록되어 있으며 — 공식 대비 17.5% 낮습니다. 586건의 실측 테스트 호출에서 얻은 기능 매트릭스와 주의 사항을 포함합니다.","icon":"puzzle","href":"/ko/api-capabilities/qwen-3-8/overview"},{"title":"Qwen3.8-Max Chat API 레퍼런스","sidebarTitle":"Chat 플레이그라운드","openapi":"api-reference/qwen-3-8-max-chat-openapi-en.yaml POST /v1/chat/completions","icon":"terminal","href":"/ko/api-capabilities/qwen-3-8/chat-completions"},{"title":"Qwen3.6 텍스트 모델 시리즈 (레거시)","sidebarTitle":"Qwen3.6 (레거시)","description":"APIYI의 Alibaba Qwen3.6 패밀리: Max-Preview 코딩 플래그십 + Flash 속도 우선 멀티모달 + Plus 균형형 워크호스 + 27B / 35B-A3B 오픈 웨이트 변형(APIYI 호스팅 — GPU 대여 불필요). 모두 Aliyun의 공식 릴레이를 통해 라우팅되며, OpenAI Chat 호환입니다. 정가는 Alibaba의 공식 요율과 동일하며, APIYI의 충전 보너스로 실질 단가는 정가의 약 85% 수준입니다.","icon":"puzzle","href":"/ko/api-capabilities/qwen-3-6/overview"}]},{"group":"Kimi K3.1 Pro","icon":"moon","pages":[{"title":"Kimi K3.1 Pro 개요","sidebarTitle":"개요","icon":"brain","href":"/ko/api-capabilities/kimi-k3-1/overview"}]},{"title":"Kimi K2.5 텍스트 생성","sidebarTitle":"Kimi K2.5","icon":"bot","href":"/ko/api-capabilities/kimi-k2-5"}]},{"group":"음성 API (공식)","icon":"audio-lines","pages":[{"title":"실시간 음성(웹소켓)","sidebarTitle":"실시간 음성 개요","icon":"audio-lines","href":"/ko/api-capabilities/realtime/overview"}]},{"group":"검색 및 안전","icon":"search","pages":[{"title":"텍스트 임베딩 API","icon":"vector-square","href":"/ko/api-capabilities/text-embedding"},{"title":"실전 임베딩 튜닝","sidebarTitle":"임베딩 튜닝","icon":"sliders-horizontal","href":"/ko/api-capabilities/embedding-best-practices"},{"group":"리랭킹","icon":"list-ordered","pages":[{"title":"bge-reranker-v2-m3 텍스트 리랭킹","sidebarTitle":"개요","icon":"list-ordered","href":"/ko/api-capabilities/rerank/overview"},{"title":"재정렬 API 레퍼런스","sidebarTitle":"플레이그라운드","openapi":"api-reference/bge-reranker-v2-m3-rerank-openapi-en.yaml POST /v1/rerank","icon":"terminal","href":"/ko/api-capabilities/rerank/rerank-api"},{"title":"RAG 튜닝 실전","sidebarTitle":"RAG 튜닝","icon":"sliders-horizontal","href":"/ko/api-capabilities/rerank/rag-best-practices"}]},{"title":"텍스트 모더레이션","icon":"shield-check","href":"/ko/api-capabilities/text-moderation"}]}]},{"tab":"활용 사례","icon":"layout-grid","pages":[{"title":"활용 사례","href":"/ko/scenarios"}]},{"tab":"FAQ","icon":"circle-question-mark","pages":[{"title":"FAQ","href":"/ko/faq"}]},{"tab":"실시간 업데이트","icon":"activity","pages":[{"title":"실시간 업데이트","href":"/ko/live"}]},{"tab":"공지사항","icon":"megaphone","pages":[{"title":"공지사항","href":"/ko/changelog"}]},{"tab":"프로모션","icon":"gift","pages":[{"title":"프로모션","href":"/ko/faq/recharge-promotions"}]},{"tab":"모델 요금","icon":"circle-dollar-sign","pages":[{"title":"모델 요금","href":"/ko/models"}]}]},{"language":"ru","banner":{"content":"Эта страница переведена с помощью ИИ. При расхождениях ориентируйтесь на [английскую версию](/en).","dismissible":true},"footer":{"socials":{"website":"https://api.apiyi.com"},"links":[{"header":"AI-интеграция","items":[{"label":"skill.md","href":"https://docs.apiyi.com/skill.md"},{"label":"llms.txt","href":"https://docs.apiyi.com/llms.txt"},{"label":"llms-full.txt","href":"https://docs.apiyi.com/llms-full.txt"},{"label":"model-registry.json","href":"https://docs.apiyi.com/model-registry.json"},{"label":"Набор AI-разработчика (кит.)","href":"/developer-kit"},{"label":"AI Developer Kit (EN)","href":"/en/developer-kit"}]},{"header":"Отзывы пользователей / Wall of Love","items":[{"label":"Отзывы пользователей (на китайском)","href":"/wall-of-love"},{"label":"Wall of Love (EN)","href":"/en/wall-of-love"}]}]},"navbar":{"links":[{"href":"https://api.apiyi.com","label":"Главная"},{"href":"https://imagen.apiyi.com","label":"Генерация изображений"},{"href":"https://icover.ai","label":"Генерация видео"}],"primary":{"type":"button","label":"Консоль","href":"https://api.apiyi.com/account/profile"}},"pages":[{"title":"ru","href":"/ru/api-capabilities/qwen-3-8/chat-completions"}]}]},"basePath":"","title":"Qwen3.8-Max Chat API 레퍼런스 - API易文档中心","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["10e4515597","c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["BannerMarkdown-CX_qQQOL.js","dist-BTZUMDnx.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","clsx-xpJZXxdP.js","html-void-elements-mCSPHezU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","AssistantPageLink-DqdKa2R4.js"]}