OpenAI 호환

IteraCompute를 통해 Vercel AI SDK가 포함된 모델을 사용하세요.

TypeScript에서 AI 경험을 구축하세요.

3단계로 연결

1. API 키 생성

IteraCompute 계정을 생성하거나 로그인한 다음 콘솔에서 키를 생성하세요.

2. 기본 URL 구성

IteraCompute baseURL을 사용하여 OpenAI 호환 제공자를 생성하고 해당 모델을 generateText에 전달합니다.

3. 모델을 선택하세요

선택한 모델에 대한 정확한 API 모델 ID를 사용하세요.에이전트 또는 비전 기능을 활성화하기 전에 해당 컨텍스트와 기능을 확인하세요.

모델을 선택하세요

예시 구성

서버 환경이나 도구 자격 증명 저장소에 API 키를 보관하세요.해당하는 경우 예제 키 필드를 사용자 고유의 키로 바꿉니다.

example.mjs · Node.js 22+
import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
import { generateText } from "ai";

if (!process.env.ITERACOMPUTE_API_KEY) {
  throw new Error("Set ITERACOMPUTE_API_KEY on the server.");
}
const itera = createOpenAICompatible({
  name: "iteracompute",
  baseURL: "https://api.iteracompute.com/v1",
  apiKey: process.env.ITERACOMPUTE_API_KEY,
});
const { text } = await generateText({
  model: itera("qwen/qwen3.8-27b"),
  prompt: "Reply with exactly: Hello!",
  maxOutputTokens: 512,
  providerOptions: { iteracompute: { chat_template_kwargs: { enable_thinking: false } } },
});
if (!text.trim()) throw new Error("Empty model reply: activation is incomplete.");
console.log(text);

연결 테스트

cURL · 채팅 완료
# Bash / zsh / WSL; set ITERACOMPUTE_API_KEY in your environment first.
curl --fail-with-body https://api.iteracompute.com/v1/chat/completions \
  -H "Authorization: Bearer $ITERACOMPUTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"qwen/qwen3.8-27b","messages":[{"role":"user","content":"Reply with exactly: Hello!"}],"max_tokens":512}'

choices[0].message.content에 보이는 텍스트가 포함되어 있는지 확인하세요.HTTP 200만으로는 부족합니다.추론은 출력 예산을 소비할 수 있습니다.무료 Qwen을 사용하려면 다음을 사용하세요. 첫 무료 API 호출 예제 사고를 비활성화하려면 도구 내부에 메시지를 보내세요.

첫 무료 API 호출

  1. 이메일을 등록하고 확인하거나 Google로 로그인하세요.카드나 충전이 필요하지 않습니다.
  2. API 키를 열고 qwen/qwen3.8-27b를 허용하는 키를 생성하고 한 번 표시된 비밀을 저장하세요.
  3. cURL 및 Python 3을 사용하여 Bash(macOS, Linux 또는 WSL)에서 이를 실행합니다. your-api-key를 키로 바꿉니다.response.json을 로컬로 유지하세요.
Bash · Qwen3.8-27B · $0
export ITERACOMPUTE_API_KEY="your-api-key"

curl --fail-with-body --max-time 180 https://api.iteracompute.com/v1/chat/completions \
  -H "Authorization: Bearer $ITERACOMPUTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"qwen/qwen3.8-27b","messages":[{"role":"user","content":"Reply with exactly: Hello!"}],"max_tokens":512,"chat_template_kwargs":{"enable_thinking":false}}' \
  -o response.json && python3 -c 'import json; r=json.load(open("response.json")); text=r["choices"][0]["message"]["content"]; assert text and text.strip(), "Empty model reply: activation is incomplete"; print(text)'

choices[0].message.content에 비어 있지 않은 텍스트가 있으면 성공입니다. 이 명령은 텍스트를 출력하며 빈 응답이면 실패합니다. 등록 또는 HTTP 200만으로는 활성화가 완료되지 않습니다. 예상 출력: Hello! (표현은 달라질 수 있습니다).

이 Qwen 예는 짧은 눈에 보이는 답변에 대한 생각을 비활성화합니다.401/403: 키와 모델 권한을 확인하세요.429: 콘솔에서 월간 사용량과 TPM을 확인한 후 Retry-After를 따릅니다.여유 용량이 대기열에 있을 수 있습니다.반복적인 병렬 재시도를 실행하지 마십시오.

전체 최소 예제 실행

Bash · setup and run
mkdir itera-ai-example
cd itera-ai-example
npm init -y
npm install ai@7.0.137 @ai-sdk/openai-compatible@3.0.67
export ITERACOMPUTE_API_KEY="your-api-key"
# Save the example above as example.mjs
node example.mjs

Node.js 22 이상을 사용하세요.서버에서 example.mjs를 실행합니다.서버 환경 변수 또는 배포 비밀에 키를 보관하세요.NEXT_PUBLIC_ 또는 VITE_를 사용하거나, .env 파일을 커밋하거나, 브라우저 코드에서 API를 호출하지 마세요.이 샘플은 무료 Qwen과 함께 채팅 완료를 사용합니다.사고 옵션은 Qwen3.8-27B에만 적용됩니다.

Node.js 25.2.1, ai 7.0.137 및 @ai-sdk/openai- Compatible 3.0.67로 2026년 10월 11일에 확인되었습니다.실제 API 결과: 안녕하세요!(선행 공백 생략).샘플은 비어 있지 않은 응답을 확인합니다.이 예제는 서버 측 CLI 애플리케이션으로 실행됩니다.

실제 표준 출력 · 2026년 10월 11일
Hello!

선택된 모델 기능

선택한 모델의 API 기능입니다.워크플로의 기능 가용성은 도구 및 해당 설정에 따라 달라집니다.추론 제어는 모델에 따라 다릅니다.

  • 채팅 완료지원됨
  • 도구 호출지원됨
  • 추론지원됨
  • 이미지 입력지원됨
  • 스트리밍지원됨

문제 해결

401 / 403

qwen/qwen3.8-27b에 대한 API 키와 권한을 확인하세요.프리 티어에는 잔액이나 카드가 필요하지 않습니다.다른 모델에는 유료 잔액이 필요할 수 있습니다.

404 / 잘못된 엔드포인트

OpenAI Compatible, /v1 기본 URL 및 qwen/qwen3.8-27b를 정확하게 사용하세요.채팅 완료 기능을 사용하세요.응답이 지원된다고 가정하지 마십시오.Qwen3.8-2.4T-A95B는 다른 유료 모델입니다.

400 / 컨텍스트 또는 빈 응답

무료의 경우 입력과 요청된 최대 출력이 131072 토큰에 맞아야 합니다.첨부파일/기록 또는 출력 예산을 줄입니다.내용이 비어 있는 HTTP 200은 불완전합니다.생각을 방해하는 짧은 무료 통화 예시를 시도해 보세요.

429 / 무료 한도

콘솔에서 계정 전체의 월간 사용량과 TPM을 확인하세요.Retry-After를 존중하고 병렬 재시도를 방지합니다.소진된 할당량에는 초과분 자동 지불이 없습니다.UTC 월별 재설정을 기다리거나 충전을 통해 더 높은 등급을 잠금 해제하세요.

401 / 403 : 키와 모델 권한을 확인하세요.무료 Qwen에는 잔액이나 카드가 필요하지 않습니다.유료 모델의 경우 사용 가능한 잔액도 확인하세요.

Vercel AI SDK 구성 참조 →

Vercel AI SDK로 구축을 시작하세요.

키를 연결하고 모델을 선택한 후 첫 번째 요청을 보내세요.