Қысқаша
CometAPI-ді OpenCode ішінде бір рет баптаңыз да, бағдарламалау тапсырмаңыз үшін Claude, GPT немесе DeepSeek таңдаңыз. Бұл нұсқаулық CometAPI OpenCode интеграциясының ресми нұсқаулығын толық жоба баптауына дейін кеңейтеді: бір CometAPI API кілті, үш модель үлгісі бар конфигурация файлы, модель ауыстыру командалары және қайталанатын тексерісі бар шағын JavaScript тапсырмасы.
Негізгі түйіндер
- OpenCode-да CometAPI баптауы провайдер ID, API base URL, credential және модель ID қажет етеді.
- Нақты API кілтін opencode.json-ға қоспау үшін {env:COMETAPI_KEY} қолданыңыз.
- Бір opencode.json ішінде Claude, GPT және DeepSeek үлгілерін тіркеңіз; үшеуі де бір CometAPI кілті мен шлюзін пайдаланады.
- Anthropic, OpenAI және DeepSeek үшін бөлек кілт алмай-ақ, OpenCode ішінде таңдаулы провайдер/модельді ауыстырыңыз.
- Жетіспейтін орта айнымалыларына, сәйкес келмейтін API маршруттарына және тоқтап қалғандай көрінетін растау сұрауларына назар аударыңыз.
OpenCode деген не және оны CometAPI-мен не үшін қолдану керек?
OpenCode — терминал интерфейсі, жұмыс үстелі қосымшасы және IDE кеңейтімі бар ашық бастапқы кодты AI кодтау агенті. Жобада ол бар кодты түсіндіре алады, өзгеріс жоспарлап, файлдарды өңдеп, берілген рұқсаттар бойынша командаларды орындайды. Бұл оқу құралы терминал жұмысын қолданады: агентке шағын бағдарламалау тапсырмасын беріңіз, оның ұсынылған әрекеттерін қарап шығыңыз және жергілікті тест арқылы алынған файлдарды тексеріңіз. Орнату және пайдалану үшін OpenCode ресми құжаттамасын қараңыз.
CometAPI модель қолжетімділік қабатын ұсынады. Көпмодельді жұмыс ағыны, әйтпесе, жеткізушілер арасында credential, биллинг және қосылым баптауларын басқаруды талап етеді. Қолдаулы модельдерді бір CometAPI тіркелгісі арқылы бағыттау бұл жобаға ортақ кілт пен base URL береді, ал OpenCode репозиторий мен тапсырма нұсқауларын сақтайды. Бұл бір тапсырмада модельдерді салыстыру немесе таңдалған модельді жобаны қайта ұйымдастырмай өзгерту үшін пайдалы. Агрегация шлюзі опциялы: тікелей жеткізушіге қол жеткізу бір провайдерлі жұмыс ағынына немесе нақты шарттық талаптарға сай келуі мүмкін. Мұндағы пайда — көп провайдерге қол жеткізуді жеңілдету; API форматтары, модель мінез-құлқы және құрал үйлесімділігі бәрібір бөлек тексерілуі керек.
CometAPI OpenAI-мен үйлесімді Chat Completions-ті қолдайды және басқа API форматтарын да ұсынады. Ресми интеграция әр формат үшін адаптер таңдайды. Мұнда Claude Sonnet 5 Messages пайдаланады, GPT-6.1 Sol Responses пайдаланады, ал DeepSeek V4.1 Flash Chat Completions пайдаланады, төмендегі үлгілерге сәйкес. Барлық сұраулар CometAPI-ге бір кілтпен жіберіледі. Жеткізуші атауы мен API форматы әртүрлі нәрселерді сипаттайды; бір модель барлық форматтарды қабылдайды деп болжауға болмайды.
| Конфигурация | CometAPI ішіндегі Claude Sonnet 5 API | CometAPI ішіндегі GPT-6.1 Sol API | CometAPI ішіндегі DeepSeek V4.1 Flash API |
|---|---|---|---|
| Модель жеткізушісі | Anthropic | OpenAI | DeepSeek |
| Модель ID | claude-sonnet-5 | gpt-6.1-sol | deepseek-v4.1-flash |
| OpenCode провайдер ID | cometapi-messages | cometapi-responses | cometapi-chat |
| Бұл жерде қолданылатын API форматы | Messages | Responses/ chat | Chat Completions |
| Адаптер | @ai-sdk/anthropic | @ai-sdk/openai | @ai-sdk/openai-compatible |
CometAPI-ді OpenCode-та баптамас бұрын не керек?
Терминал, npm бар Node.js, API қолжетімділігі мен балансы бар CometAPI тіркелгісі және бір реттік жоба қалтасы қажет. Bash үлгілері macOS, Linux немесе WSL үшін жарамды; белгіленген PowerShell үлгілері Windows синтаксисін қолданады. Бұл нұсқаулықтың кейінгі JavaScript тексерісі үшін де Node.js сол сессияда қолжетімді болуы керек.
Бұл жүріс OpenCode 1 конфигурация стилін қолданады. Ресми құжаттама OpenCode 1 мен OpenCode 2-ні ажыратады; екеуі де opencode командасын қолданады. Бастағанға дейін opencode --version жазып алыңыз және сол мажор нұсқаға арналған конфигурация құжатын қолданыңыз. Төмендегі үш-модельді жұмыс — күтілетін нәтижелері бар интеграция жүрісі, толыққанды end-to-end тест талап етілгені туралы мәлімдеу емес.
Мысалдарды орындағанда CLI, Node.js, npm, операциялық жүйе және тест күнін жазып алыңыз. API пайдалану CometAPI тіркелгіңізге есептеледі. Төмендегі командалар — күтілетін нәтижелері бар практикалық жүріс; модель жасаған шығыс немесе үш модельмен сәтті интеграция іске қосылды деген мәлімдеме жоқ.
node --versionnpm --versionopencode --version
CometAPI-ді OpenCode-та қалай қадамдап баптауға болады?
Қадам 1: OpenCode орнату
OpenCode қолжетімді болмаса, ресми npm пакетін орнатыңыз. Бекітілмеген орнату ағымдағы пакет релизін қояды; конфигурацияны қолданар алдында орнатылған нұсқаны жазып алыңыз. Егер бастапқы нұсқаулықтың ортасын қайта шығарғыңыз келсе, онда көрсетілген CLI нұсқасы 1.18.16.
OpenCode CLI-ді орнатып, оның нұсқасын шығарыңыз.
npm install -g opencode-aiopencode --version
Орнатудан кейін орындалатын файл табылмаса, жаңа терминал ашыңыз. Алғашқы агент тапсырмасының айқын шекарасы болуы үшін бір реттік жоба қалтасы ішінде жалғастырыңыз.
Жоба қалтасын жасап, ішіне кіріңіз.
mkdir cometapi-opencode-democd cometapi-opencode-demo
Қадам 2: CometAPI API кілтін жасау
CometAPI тіркелгіңізден API кілтін генерациялап, оны OpenCode іске қосылатын сол терминалда орнатыңыз. Жергілікті түрде плейсхолдерді ауыстырыңыз. Кілтті коммит жасамаңыз, prompt-тарға жапсырмаңыз, немесе ортақ журналдарға қоспаңыз.
Айнымалы ағымдағы shell мен одан іске қосылған процестерге қолданылады. Нақты токенді скриншот жасамаңыз. Төмендегі тексерістер мәнді шығармай-ақ айнымалының бар-жоғын хабарлайды.
Ағымдағы Bash сессиясы үшін CometAPI кілтін орнатыңыз.
export COMETAPI_KEY="YOUR_COMETAPI_KEY"
Ағымдағы PowerShell сессиясы үшін CometAPI кілтін орнатыңыз.
$env:COMETAPI_KEY = "YOUR_COMETAPI_KEY"test -n "$COMETAPI_KEY" && printf "COMETAPI_KEY is set\n" || printf "COMETAPI_KEY is missing\n"if ([string]::IsNullOrWhiteSpace($env:COMETAPI_KEY)) { "COMETAPI_KEY is missing"} else { "COMETAPI_KEY is set"}
Қадам 3: opencode.json жасау
opencode.json файлын жоба түбіріне жасаңыз немесе жазбаларды жобалар арасында қолжетімді ету үшін ~/.config/opencode/opencode.json қолданыңыз. Жоба файлы бұл оқулықты өзіндік етеді. Төмендегі үш жазбасы бар бір провайдер объектісін пайдаланыңыз; егер провайдер объектісі бар болса, жаңа JSON кілтін көшірмей, оның ішіне жазбаларды біріктіріңіз.
Қайшылық туса, жоба конфигурациясы жаһандық конфигурацияны басып жазады; қайшылықсыз өрістер сақталады. Пайдаланушы OPENCODE_CONFIG файлы жаһандық пен жоба конфигурациясының арасында жүктеледі. Басқарылатын немесе inline баптаулар да болса, құжатталған басымдық тізбегін тексеріңіз.
Төмендегі толық конфигурацияны opencode.json ретінде сақтаңыз. Әр провайдер COMETAPI_KEY мәнін ортадан оқиды. Әдейі әдепкі модель көрсетілмеген — үш үлгінің бірін нақты таңдауыңыз керек.
Flash нұсқасы сұралған DeepSeek V4.1 үлгісін нақтылайды. Құралдарды пайдалану үшін GPT-ні Responses адаптерінде ұстаңыз; CometAPI DeepSeek нұсқаулығында мұнда қолданылған Chat Completions маршруты құжатталған. Үлгілерді іске қоспас бұрын тіркелгіңіздегі модель қолжетімділігін және рұқсаттарды қайта тексеріңіз.
{ "$schema": "https://opencode.ai/config.json", "provider": { "cometapi-messages": { "npm": "@ai-sdk/anthropic", "name": "CometAPI Claude", "options": { "baseURL": "https://api.cometapi.com/v1", "apiKey": "{env:COMETAPI_KEY}" }, "models": { "claude-sonnet-5": { "name": "Claude Sonnet 5" } } }, "cometapi-responses": { "npm": "@ai-sdk/openai", "name": "CometAPI GPT", "options": { "baseURL": "https://api.cometapi.com/v1", "apiKey": "{env:COMETAPI_KEY}" }, "models": { "gpt-6.1-sol": { "name": "GPT-6.1 Sol" } } }, "cometapi-chat": { "npm": "@ai-sdk/openai-compatible", "name": "CometAPI DeepSeek", "options": { "baseURL": "https://api.cometapi.com/v1", "apiKey": "{env:COMETAPI_KEY}" }, "models": { "deepseek-v4.1-flash": { "name": "DeepSeek V4.1 Flash" } } } }, "permission": { "edit": "ask", "shell": "ask" }}
Дұрыс baseURL: https://api.cometapi.com/v1. Дұрыс емес baseURL: https://api.cometapi.com/v1/chat/completions. Адаптер endpoint жолын өзі қосады. Үлгіні бар opencode.json файлына байланыссыз параметрлерді жоймай біріктіріңіз.
edit және shell баптаулары ағымдағы OpenCode рұқсат ережелеріне сай файл өзгерістері мен командалар үшін растау сұрайды. Кодтау мысалдарын интерактивті орындап, осы сұрауларды қарап шығыңыз. OpenCode сондай-ақ оны іске қосқан процестің операциялық жүйе құқықтарын мұрагерлейді; бұл жаттығу үшін бір реттік қалтаны қолданыңыз.
Қадам 4: Шлюз қосылымын тексеру
Опциялы Gemini баптауы мен растауы төмендегі үш модель қосылым тексерістерінен кейін берілген.
Төмендегі HTTP мысалы DeepSeek Chat Completions жазбасын тікелей тексереді. Бұл шлюз қосылымын OpenCode-тен бөліп алудың пайдалы тәсілі. Claude және GPT келесі қадамда өздерінің таңдалған адаптер маршруттарын қолданады; осы HTTP сұрау ішіндегі модель ID-ін өзгерту оның протоколын автоматты түрде өзгертпейді.
Bash ішінен минималды Chat Completions сұрауын жіберіңіз.
curl --silent --show-error \ --output response.json \ --write-out "HTTP %{http_code}\n" \ https://api.cometapi.com/v1/chat/completions \ -H "Authorization: Bearer $COMETAPI_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"deepseek-v4.1-flash","messages":[{"role":"user","content":"Reply with a short greeting."}]}'
Бұл команда curl write-out және output опцияларын HTTP күйін response.json-нан бөлу үшін қолданады. Сәтті тасымалдау HTTP қатесін қамтуы мүмкін, сондықтан басып шығарылған күйді және JSON денесін тексеріңіз. Бұл curl 7.76.0 және одан кейінгілерді талап ететін --fail-with-body-ға тәуелділіктен қашады.
Shell-ге тән JSON тырнақша қоюсыз PowerShell-ден дәл сол сұрауды жіберіңіз.
$body = @{ model = "deepseek-v4.1-flash" messages = @(@{ role = "user"; content = "Reply with a short greeting." })} | ConvertTo-Json -Depth 4$response = Invoke-WebRequest -UseBasicParsing -Method Post ` -Uri "https://api.cometapi.com/v1/chat/completions" ` -Headers @{ Authorization = "Bearer $env:COMETAPI_KEY" } ` -ContentType "application/json" ` -Body $body$response.Content | Set-Content -Encoding UTF8 response.json"HTTP $($response.StatusCode)"
HTTP қатесі кезінде PowerShell соңғы екі жол орындалмай тұрып, ерекшелік тудыруы мүмкін. Сол сәтсіздіктен күйді және редакцияланған қате мәліметтерін ұстаңыз; оны сәтті жауап ретінде тіркемеу керек.
DeepSeek сұрауы үшін күтілетін нәтиже: HTTP 200 және choices[0].message.content ішінде бос емес мәтін. Тек HTTP 200-ге сенбестен, сақталған response.json файлын тексеріңіз. Төмендегі толықтырулар жауап пішінін және үш конфигурацияланған маршрутты қалай тексеруге болатынын көрсетеді. Үлгілер көрнекі; бұл нұсқа CometAPI-дің нақты тірі тест нәтижелерін мәлімдемейді. Тек мәтіндік сұрау ағындық беруді немесе құрал шақыруларын растамайды.
Көрнекі DeepSeek жауап пішіні: сәлемдесу, usage мәндері және басқа өрістер нақты сұрауға тәуелді. Төмендегі JSON әдейі қысқартылған мысал, нақты API жауабы емес.
{"choices":[{"message":{"role":"assistant","content":"Hello!"}}]}
Нақты сәтті HTTP сұрауынан кейін, күй жолы HTTP 200 болуы керек және response.json ішінде көмекші мәтін бос болмауы тиіс. Өз жүгірісіңіз үшін нақты күй мен денені сақтаңыз; үлгіні тест дәлелі ретінде көшірмеңіз.
Қадам 5: Claude, GPT және DeepSeek арасында ауыстыру
Бұл қадамдағы командалар сұралған көмекші маркерлерді қайтаруы тиіс. Көрнекі көмекші мәтін, терминал баннері, уақыт және метадеректер алынған:
Claude: CLAUDE_READYGPT: GPT_READYDeepSeek: DEEPSEEK_READY
Бұл жолдар тек күтілетін мазмұнды көрсетеді. Олар терминал транскрипті емес. Әр провайдер үшін нақты шығысты және процесс шығу күйін жазып алыңыз; маркердің болмауы немесе сәтсіз сұрау — зерттеуді қажет етеді.
opencode.json бар қалтадан бастаңыз. Әр конфигурацияланған провайдер үшін модельдерді тізімдеңіз, содан кейін әр жазбаға қысқа мәтіндік сұрау жіберіңіз. Бұл командалар таңдалған модель мен адаптерді ауыстырады; CometAPI кілті мен base URL өзгермейді.
Үшеуінің де көрінетінін және мәтін қайтара алатынын тексеру үшін осы командаларды қолданыңыз.
opencode models cometapi-messagesopencode models cometapi-responsesopencode models cometapi-chatopencode run --model cometapi-messages/claude-sonnet-5 "Reply exactly with: CLAUDE_READY"opencode run --model cometapi-responses/gpt-6.1-sol "Reply exactly with: GPT_READY"opencode run --model cometapi-chat/deepseek-v4.1-flash "Reply exactly with: DEEPSEEK_READY"
Интерактивті ауыстыру үшін opencode іске қосыңыз, /models енгізіңіз және CometAPI Claude, CometAPI GPT немесе CometAPI DeepSeek таңдаңыз. OpenCode сол жазбаның провайдер/модель жұбын қолданады. Үш жеткізуші тіркелгісі немесе үш API кілті қажет емес. Ортамен қамтамасыз етілген бұл конфигурацияда екінші credential беру үшін /connect қолданбаңыз; жетіспейтін COMETAPI_KEY іске қосатын shell ішінде түзетілуі керек.
Күтілетін нәтиже: әр қысқа сұрау сұралған маркерді қайтарады. Әр модель үшін нақты нәтижені жазып алыңыз. Көрінетін модель жазбасы тіркеуді растайды; сәтті мәтіндік жауап — сұрау жолын растайды. Екеуінің бірі ғана файл құралдарының жұмысын дәлелдемейді.
Gemini бөлек провайдер мен протоколды қолданады. Жоғарыдағы Claude, GPT және DeepSeek жазбаларын сақтаңыз; төмендегі жазбаны бар провайдер объектісіне біріктіріңіз. Төмендегі base URL рецензент ұсынған CometAPI конфигурациясын ұстанады. Қолданар алдында CometAPI тіркелгіңіздегі ағымдағы маршрут пен модель қолжетімділігін растаңыз.
Google адаптері теңшелетін baseURL-ді қолдайды және apiKey мәнін x-goog-api-key арқылы жібереді. AI SDK Google провайдері туралы ресми анықтаманы қараңыз. Бұл адаптер баптауларын растайды; белгілі бір Gemini моделінің CometAPI шлюзінде қосулы екенін дәлелдемейді.
{ "provider": { "cometapi-gemini": { "npm": "@ai-sdk/google", "name": "CometAPI Gemini", "options": { "baseURL": "https://api.cometapi.com/v1beta", "apiKey": "{env:COMETAPI_KEY}" }, "models": { "YOUR_GEMINI_MODEL_ID": { "name": "CometAPI Gemini (account-selected model)" } } } }}
YOUR_GEMINI_MODEL_ID мәнін төмендегі командада да, JSON кілтінде де CometAPI тіркелгіңізде қосулы дәл Gemini модель ID-іне ауыстырыңыз. Бұл плейсхолдер, нақты модель ID емес. Бұл провайдер жазбасын жоғарыдағы топ- деңгейлі provider кілтін қайталамай біріктіріп, COMETAPI_KEY орнатылған сол shell-ден OpenCode іске қосыңыз.
opencode models cometapi-geminiopencode run --model cometapi-gemini/YOUR_GEMINI_MODEL_ID "Reply exactly with: GEMINI_READY"
Күтілетін көмекші мәтін: GEMINI_READY. Тізімделген модель — жергілікті тіркеуді растайды; маркерді алу — мәтіндік сұрауды растайды. Нақты жауап пен шығу күйін сақтаңыз. Құралдарды растау үшін, жаңа бір реттік қалтада opencode --model cometapi-gemini/YOUR_GEMINI_MODEL_ID іске қосып, төмендегі greet.cjs/check.cjs тапсырмасын қайталаңыз. Тек мәтіндік сәттілік ағындық беру, өңдеу немесе құрал шақыруларын тексермейді.
Claude, GPT және DeepSeek-пен кодтау тапсырмасын қалай орындауға болады?
Әр модель үшін бірдей шағын тапсырманы қолданыңыз: сәлемдесу функциясын жазыңыз, assert қосыңыз және іске қосыңыз. Үш бөлек жаңа қалтаны қолданыңыз, сонда екінші модель біріншінің жасаған файлдарын жай ғана қайта пайдаланбайды. Бұл өнімділік рейтингін жасамай-ақ интеграция жұмыс ағынын тексереді.
prepare-runs.cjs файлын opencode.json қасына сақтап, бір рет іске қосыңыз. Ол үш жаңа қалта жасайды және тек ортақ конфигурацияны көшіреді. Нысана қалталардың кез келгені бар болса, ол тоқтайды — алдыңғы жұмыс үстіне жазылмайды.
const fs = require("node:fs");const path = require("node:path");const root = __dirname;const names = ["claude-demo", "gpt-demo", "deepseek-demo"];const config = path.join(root, "opencode.json");if (!fs.existsSync(config)) throw new Error("Missing opencode.json");for (const name of names) { if (fs.existsSync(path.join(root, name))) { throw new Error(`Directory already exists: ${name}`); }}for (const name of names) { const dir = path.join(root, name); fs.mkdirSync(dir); fs.copyFileSync(config, path.join(dir, "opencode.json"));}node prepare-runs.cjscd claude-demoopencode --model cometapi-messages/claude-sonnet-5# After exiting OpenCode:cd ..cd gpt-demoopencode --model cometapi-responses/gpt-6.1-sol# After exiting OpenCode:cd ..cd deepseek-demoopencode --model cometapi-chat/deepseek-v4.1-flash# After exiting OpenCode:cd ..
Сессиялардың бірін бір уақытта, бастапқы жоба қалтасынан іске қосыңыз. Келесі мысалға өтпес бұрын сессиядан шығыңыз. Әр сессияда төмендегі бірдей тапсырманы жіберіңіз және ұсынылған өңдеулер мен командаларды шолып шығыңыз. OpenCode іске қосатын процесте Node.js қолжетімді болуы тиіс.
Агенттен шағын JavaScript функциясын құрып, тексеруді сұраңыз.
Create greet.cjs in this directory.Export a function named greet(name) that returns "Hello, " + name + "!".Create check.cjs using node:assert/strict.Assert that greet("Ada") equals "Hello, Ada!".Run node check.cjs and report its actual exit status.Do not modify opencode.json or unrelated files.
Күтілетін нәтиже: агент конфигурацияланған растауларды сұрайды, екі файлды да жасайды және node check.cjs командасын 0 шығу кодымен аяқтайды. Шын мәнінде не болғанын жазып алыңыз. Файлдарды тексеріп, өзіңіз де тексеруді қайта іске қосыңыз; жай сөзбен сәттілік мәлімдемесі жеткіліксіз. Құрал шақыруы қабылданбаса немесе дұрыс құрылмаса, рұқсат күту күйінен бөлек маршрут үйлесімділігін зерттеңіз.
Анықтама файлдары және жергілікті верификация
Төмендегі файлдар — сұралған тапсырманың анықтама іске асыруы. Олар осы нұсқаулық үшін тікелей жазылды; модель жасаған артефактілер ретінде ұсынылмайды. Олардың байқалатын мінез-құлқымен сәйкестік — агент жұмысыңыз үшін қабылдау шарты.
function greet(name) { return "Hello, " + name + "!";}module.exports = { greet };const assert = require("node:assert/strict");const { greet } = require("./greet.cjs");assert.equal(greet("Ada"), "Hello, Ada!");node check.cjsprintf "exit=%s\n" "$?"node check.cjs"exit=$LASTEXITCODE"
Жергілікті анықтама тексерісі: Windows, Node.js v24.19.0, 2026 жылғы 22 қазан; node check.cjs стандартты шығысыз 0 шығу кодын қайтарды. Бұл тек екі анықтама файлын тексереді. Ол OpenCode орнатуын, CometAPI қолжетімділігін, растау сұрауларын немесе модель құрал шақыруларын растамайды.
| Жүгіріс | Таңдалған модель жазбасы | Нені жазу керек |
|---|---|---|
| Claude | cometapi-messages/claude-sonnet-5 | Жауап, жасалған файлдар, растаулар, тест шығу коды |
| GPT | cometapi-responses/gpt-6.1-sol | Жауап, жасалған файлдар, растаулар, тест шығу коды |
| DeepSeek | cometapi-chat/deepseek-v4.1-flash | Жауап, жасалған файлдар, растаулар, тест шығу коды |
Әр модель бойынша бір нәтиже жазбасын ұстаңыз: таңдалған провайдер/модель, жауап келді ме, greet.cjs және check.cjs жасалды ма, растаулар көрінді ме, және node check.cjs шығу коды. Сәтсіздіктерді сәтсіздік ретінде тіркеңіз; анықтама іске асырудан өткен деп тұжырым жасамаңыз.
Құпия деректерді қорғау және сенімділікті тексеру
COMETAPI_KEY мәнін конфигурация файлдарына немесе ортақ журналдарға емес, орта айнымалысында сақтаңыз. Файл өңдеу және shell команда рұқсаттарын қосулы күйде ұстаңыз, жаңа конфигурацияларды бір реттік жобада тексеріңіз.
Тікелей API сұрауын, OpenCode жауаптарын және файл өңдеу жұмысын бөлек растаңыз. Қателер мен тест нәтижелерін жазып, тек өткінші сәтсіздіктерді ғана қайталап көріңіз және үзілген тапсырмаларды қайталаудан бұрын жұмыс аймағын тексеріңіз.
CometAPI модельдер арасында ауысуды оңайлатады, бірақ бұл конфигурация арқылы OpenCode автоматты кросс-модель failover ұсынбайды. Модель қолжетімсіз болса, расталған басқа модельді қолмен таңдаңыз және қабылдау тексерісін қайталаңыз.
OpenCode-ты CometAPI-мен қолдану қанша тұрады?
CometAPI бағалары және биллинг құрылымы
CometAPI ай сайынғы абоненттік төлемсіз, тек нақты API пайдалануы үшін ақы алатын pay-as-you-go баға моделін ұсынады. Ресми модель бағалары әдетте провайдерлердің стандартты бағаларынан 20% төмен, қосымша көлемдік жеңілдіктер қолжетімді. Әзірлеушілер Claude, GPT, DeepSeek және басқа модельдерге бір тіркелгі арқылы қол жеткізіп, таңдалған модельдің токен тұтынуына қарай төлейді. Ағымдағы тарифтер үшін CometAPI бағалар бетіне қараңыз.
Кэштеу немесе қосымша алымдарсыз сұраулар үшін:
Құны = (Кіріс токендері × Кіріс бағасы + Шығыс токендері × Шығыс бағасы) / 1,000,000
Мысалы, гипотетикалық $1/M кіріс токені және $4/M шығыс токені бағаларымен, 20,000 кіріс және 2,000 шығыс токені $0.028 тұрады. Бұлар көрнекі тарифтер, нақты модель бағалары емес.
Әр тапсырма үшін токен пайдалануды, жалпы API шығындарын, орындалу уақытын және тест нәтижелерін жазып жүріңіз. Құнын азайту үшін қажетсіз контексті шектеңіз, қысқа prompt-тар қолданыңыз, қайталанатын сәтсіз сұраулардан аулақ болыңыз және сапа талаптарын өтейтін төменірек құнды модельдерді таңдаңыз.
OpenCode API құнын оңтайландыру стратегиялары
Кодтау сапасын құрбан етпей OpenCode шығындарын азайту үшін модель таңдауы, токен тиімділігі және қажетсіз API сұрауларын қысқартуға назар аударыңыз.
- Дұрыс модельді таңдаңыз: кәдімгі кодтау тапсырмалары үшін DeepSeek сияқты төменірек құнды модельдерді қолданыңыз, ал күрделі дебаг, рефакторинг және reasoning үшін Claude немесе GPT сақтаңыз.
- Токен тұтынуды азайтыңыз: prompt-тарды қысқа ұстаңыз, тек сәйкес жоба файлдарын беріңіз және репозиторий контекстін үлкен көлемде қайта-қайта жіберуден аулақ болыңыз.
- Prompt кэштеуді қолданыңыз: жобалық нұсқаулар мен код сілтемелері сияқты қайталанатын контекст үшін қолдау көрсетілетін кэштеу мүмкіндіктерін пайдаланыңыз, осылайша кіріс құнын азайтыңыз.
- Қажетсіз қайталаулардан аулақ болыңыз: сұрауларды қайта жібермес бұрын конфигурация және аутентификация қателерін жөндеңіз, және қайталама жұмыстан сақтану үшін алдыңғы шығыстарды қарап шығыңыз.
- Нақты шығындарды бақылаңыз: CometAPI арқылы токен пайдалануды, API шығындарын және сәтті аяқталған тапсырмаларды қадағалаңыз. Тек токен бағаларын емес, сәтті тапсырмаға жұмсалған құнды салыстырыңыз.
CometAPI-дің жеңілдетілген pay-as-you-go бағаларымен бірге, бұл тәжірибелер әзірлеушілерге OpenCode-та сенімді кодтау өнімділігін сақтай отырып, шығындарды бақылауға көмектеседі.
CometAPI конфигурациясын қалай кеңейтуге болады?
Жаңа модель қосу үшін, оның модель ID-ін тиісті API форматын қолдайтын провайдердің астына орналастырыңыз немесе қажет адаптері бар жаңа провайдер жазбасын қосыңыз. Содан кейін /models арқылы сол провайдер/модельді таңдаңыз. Credential-дарды COMETAPI_KEY ішінде сақтаңыз және ауысу тек таңдау операциясы болып қалуы үшін бар жазбаларды сақтаңыз.
Ресми нұсқаулық төрт API форматын қамтиды, оның ішінде Gemini. Бұл мақала Claude, GPT және DeepSeek үшін керек үш жазбаны қолданады. Егер таңдалған бірнеше модель Chat Completions қолдаса, олар бір cometapi-chat models картасын бөлісе алады. Responses-only немесе Messages-only маршруттарын жай карталар санын азайту үшін сол картаға көшірмеңіз.
Адаптерді — шақырғыңыз келетін маршрутқа, ал модельді — бағдарламалау тапсырмасына қарай таңдаңыз. Жеткізушіні ауыстыру жаңа CometAPI кілтін талап етпейді; API форматын ауыстыру — сәйкес конфигурацияланған адаптерді талап етеді.
OpenCode-та CometAPI ақауларын қалай жоюға болады?
Алғаш сәтсіз болған кезеңді қадағалаңыз: HTTP сұрау → OpenCode провайдері → файл құралдары. Егер HTTP сәтсіз болса, credential-дарды, модель қолжетімділігін және endpoint мәліметтерін тексеріңіз. Егер HTTP жұмыс істеп, бірақ OpenCode сәтсіз болса, конфигурацияны және іске қосу ортасын тексеріңіз. Егер мәтіндік тексерістер жұмыс істеп, файл әрекеттері сәтсіз болса, рұқсаттарды және құрал шақыруы үйлесімділігін тексеріңіз.
| Белгісі | Алғашқы тексеріс | Келесі әрекет | Диагностикалық команда/дәлел |
|---|---|---|---|
| 401 жауабы | Кілт мәні және Authorization тақырыбы | Кілтті ағымдағы терминалда орнатыңыз; байқаусызда бос орындар жоқтығын тексеріңіз. | Кілтті басып шығармай айнымалының бар-жоғын тексеріңіз; HTTP күйін және редакцияланған қатені сақтаңыз. |
| 403 немесе тіркелгі шектеуі | Қате денесі және тіркелгі рұқсаттары | CometAPI ішінде модельге қолжетімділік пен тіркелгі күйін растаңыз. | Редакцияланған қате жауабын сақтаңыз және тіркелгі қолжетімділігін растаңыз. |
| 404 жауабы | Хост, endpoint жолы және модель ID | Сұрауды таңдалған модельдің API құжаттамасымен салыстырыңыз. | response.json файлын сұралған модель мен endpoint-ке салыстырыңыз. |
| OpenCode-та модель жоқ | Жоба қалтасы және провайдер конфигурациясы | JSON валидтілігін және сәйкес провайдер/модель атауларын тексеріңіз; түзетуден кейін қайта іске қосыңыз. | opencode models cometapi-chat, opencode models cometapi-messages және opencode models cometapi-responses командаларын іске қосыңыз; opencode --version жазып алыңыз. |
| Мәтін жұмыс істейді, құралдар сәтсіз | Құрал шақыру жауабы және адаптер үйлесімділігі | Маршрут қолдауын растаңыз; қабылданбаған құрал шақыруын растау сұрауынан ажыратыңыз. | Қысқа мәтіндік сұрауды сәтсіз құрал әрекетімен салыстырыңыз; қатені сақтаңыз. |
| Команда растауды күтуде | Интерактивті сессия және рұқсат баптаулары | Көзделген әрекетті қарап, мақұлдаңыз; рұқсат күтуін API ақауы ретінде бағаламаңыз. | Интерактивті сессияны қолданыңыз; сұралған әрекет пен растау нәтижесін жазып алыңыз. |
| 429 немесе өткінші сервер қатесі | Қате деректері және пайдалану шектері | Сұраулар параллелдігін азайтыңыз; тоқтаусыз қайталаудың орнына ретри нұсқауларын орындаңыз. | HTTP күйін және ретри нұсқауын сақтаңыз; параллелдікті азайтыңыз. |
Мәселені бөліскенде, OpenCode нұсқасын, операциялық жүйені, модель ID-ін, endpoint жолын және редакцияланған қате мәтінін қосыңыз. API кілттерін және жеке репозиторий мазмұнын қоспаңыз. Сәтсіздікті қайталайтын ең кіші сұрауды сақтаңыз, сонда конфигурация және құрал сәтсіздіктері бөлек зерттеледі.
Жиі қойылатын сұрақтар
Неге OpenCode жаңа терминалда CometAPI кілтімді «жоғалтады»?
Жоғарыдағы export және PowerShell командалары орта айнымалысын ағымдағы сессия мен оның еншілес процестері үшін қояды. Бөлек ашылған терминал немесе әлдеқашан іске қосылып тұрған редактор оны мұрагерлемеуі мүмкін. OpenCode-ты іске қосатын ортада кілтті орнатып, сол процесті қайта іске қосыңыз. Тұрақты баптау үшін, құпияны репозиторий файлына енгізбей, ортаңыздың credential басқаруын қолданыңыз.
OpenCode .env файлын COMETAPI_KEY мәнімен автоматты түрде жүктей ме?
{env:COMETAPI_KEY} өрнегі процестің ортасын оқиды. Жай ғана .env файлын жасау айнымалының жүктелгенін білдірмейді. OpenCode-ты іске қоспас бұрын shell немесе ашық түрде бапталған орта жүктеушісін қолданыңыз. Провайдер қолжетімсіз деп ойламай, іске қосатын процесте бос мәнді диагностикалаңыз.
Жаһандық OpenCode конфигурациясы бұл жоба баптауын өзгерте ала ма?
OpenCode конфигурацияны толық алмастырмай, біріктіреді. Жоба файлы жаһандық файлдағы қабаттасатын өрістерді басып жазады, ал байланыссыз жаһандық баптаулар сақталады. Таңдамалы OPENCODE_CONFIG файлы олардың арасында жүктеледі. Мінез-құлық репозиторийлер арасында әртүрлі болса, жергілікті файл жалғыз дерек деп ойламай, осы көздерді және басқарылатын немесе inline баптауларды салыстырыңыз.
Модель тізімін жаңарту CometAPI қолжетімділігін қосады ма?
Жоқ. Модель жаңарту параметрі models.dev кэшін жаңартады; ол тіркелгі қолжетімділігін бермейді және endpoint модель ID-ін қабылдайтынын дәлелдемейді. Қолмен конфигурацияланған жазба сәтті сұраудан бұрын да көрінуі мүмкін. Маршрутты тексеру үшін нақты сұрауды қолданыңыз және қолжетімділік шектеулері үшін CometAPI тіркелгі баптауларын қараңыз.
Неге curl жұмыс істейді, ал OpenCode CometAPI-ге қоңырау жасай алмайды?
Екі процесс әртүрлі credential жүктеуі, әртүрлі модель ID қолдануы немесе әртүрлі сұрау пішіндерін жіберуі мүмкін. Алдымен сәтті HTTP сұрауымен бір терминалда қысқа мәтіндік prompt-ты қайта іске қосыңыз. Содан соң провайдердің base URL-ін, адаптерін және таңдалған моделін салыстырыңыз. Егер қарапайым мәтін жұмыс істесе, ал агент тапсырмасы сәтсіз болса, құралға қатысты қатені бөлек сақтаңыз; HTTP байланыстылығы ғана құрал үйлесімділігін көрсетпейді.
Қорытынды
Енді сізде Claude, GPT және DeepSeek үлгілері бар бір opencode.json, ортақ CometAPI credential-ы және белсенді модельді ауыстыру командалары бар. Қолжетімділікті тексеру үшін қысқа мәтіндік сұрауларды пайдаланыңыз, содан кейін бірдей файл жасау тапсырмасын бөлек қалталарда іске қосып, кодтау жұмыс ағынын растаңыз. Бұл баптауды үлкенірек репозиторийге қолданбас бұрын, байқаған нәтижелеріңізді орта деректерімен бірге сақтаңыз.