시작하기 전에: API 키 발급받기
아래 내용 전부 — 에이전트, 이미지, 영상, 직접 API 호출 — 이 키 하나만 있으면 됩니다.
- Octer 콘솔을 엽니다: octer.ai/workspace/o/ → (계정이 없다면 먼저 가입하세요)
- OClaw 페이지에서 복사를 눌러 API 키를 받으세요.
🎁 신규 가입 / 로그인 시 체험 크레딧을 드립니다. 키만 받으면 바로 무료로 써 볼 수 있고, 충전은 그다음에 생각해도 됩니다. 가입하고 크레딧 받기 →
잠깐 시간을 내어 키가 잘 동작하는지 확인해 보세요(먼저 OS를 고른 뒤 복사하세요. JSON 응답이 오면 키와 네트워크 모두 정상입니다):
아래 모든 명령에 있는 YOUR_API_KEY 는 본인의 키로 바꿔 주세요.
JSON이 안 오거나 401 / 403이 뜨나요? "문제 해결 →"에 각 경우의 해결법이 있습니다.
에이전트 연결
OpenClaw와 Hermes는 모두 무료 오픈소스 '로컬 AI 어시스턴트'입니다. 내 컴퓨터에 설치해 터미널에서 대화하는 방식이죠. 아직 설치 전이어도 괜찮습니다. 아래 1단계가 처음부터 안내합니다.
사용 중인 에이전트와 OS를 고르세요. 아래 명령이 그에 맞게 바뀝니다.
1단계 · 클라이언트 설치
CLI가 정상적으로 잡히는지 확인합니다:
2단계 · Octer 모델로 전환
스크립트가 엔드포인트와 키, 모델을 기록하고 게이트웨이를 재시작한 뒤 테스트로 “안녕”을 보냅니다. 모델이 정상적으로 답하면 설정 완료입니다.
3단계 · 확인
아래 두 명령을 차례로 실행하세요:
마음이 바뀌었나요? 되돌리기
이 명령은 Octer 모델 설정만 지우고, 나머지 설정은 그대로 둡니다.
이미지 & 영상
앞 단계는 대화만 해결해 줍니다. 에이전트가 이미지와 영상까지 만들게 하려면 oclaw 스킬을 추가하세요. 세 가지 기능을 한데 묶은 작은 CLI로, 생성한 파일을 바로 로컬에 저장해 줍니다.
가장 쉬운 방법: OpenClaw / Hermes 대화창에 이 문장을 붙여넣으면 에이전트가 알아서 설치합니다.
아직 OpenClaw / Hermes가 없나요? "에이전트 연결 →" 섹션을 보세요 — 명령 두 줄이면 됩니다. 에이전트 없이 쓰려면 아래 터미널 방식을 이용하세요.
본인의 키로 바꿔 넣으세요. 그다음부터는 “…한 이미지 만들어 줘”, “…한 영상 만들어 줘”처럼 평소 말투로 이야기하면 에이전트가 알아서 처리합니다.
터미널에서 직접 실행할 수도 있습니다(Python 3 외에 별도 의존성 없음):
Windows 사용자: 이 도구는 bash 스크립트입니다. WSL이나 Git Bash에서 실행하세요 (PowerShell에서는 바로 실행되지 않습니다).
- 이미지는
images/, 영상은videos/에 저장됩니다. - 영상은 비동기입니다. 보통 1~3분 걸리며, CLI가 알아서 기다렸다가 내려받습니다. 타임아웃이 나도 사라지는 건 없습니다. 작업은 계속 진행 중이니
./oclaw.sh status로 작업 ID를 확인한 뒤./oclaw.sh watch <task-id>를 실행하세요. - 영상 링크는 약 24시간 뒤 만료되므로 작업이 끝나는 즉시 내려받으세요. CLI는 이미 그렇게 동작합니다. API를 직접 호출한다면 링크만 저장해 두지 마세요.
API 직접 호출
에이전트가 필요 없습니다. Octer를 직접 만든 프로그램에 붙이려면 HTTP API를 호출하면 됩니다. 게이트웨이가 OpenAI 프로토콜을 지원하므로, 공식 SDK에서 base_url 만 바꾸면 그대로 동작합니다.
모델 목록
API 호출이나 에이전트 설정에 넣는 값은 model id입니다. 표에서 배경색이 있는 문자열이 바로 그것이며, 옆의 버튼으로 한 번에 복사할 수 있습니다.
| 분류 | 모델 | model id | 설명 |
|---|
같은 분류 안에서 모델을 바꾸려면 model id 만 바꾸면 됩니다. 대화와 추론은 엔드포인트를 함께 쓰고, 이미지와 영상은 각자의 엔드포인트를 사용합니다. 위 코드 예시는 선택한 모델에 맞춰 자동으로 바뀝니다.
모델 가격표
| Model | Vendor | Context | 공식 / 1M | OClaw / 1M |
|---|---|---|---|---|
Gemini 4 Argon NEW google / gemini-4-argon | — | Input: $2 Output: $10 | Input: $1.6 Output: $8 20% 절약 | |
Gemini 3.8 Flash NEW google / gemini-3.8-flash | — | Input: $0.75 Output: $3.75 | Input: $0.75 Output: $3.75 | |
GPT-6 Astra NEW openai / gpt-6-astra | OpenAI | — | Input: $20 Output: $75 | Input: $16 Output: $60 20% 절약 |
GPT-6 Sol NEW openai / gpt-6-sol | OpenAI | — | Input: $4 Output: $15 | Input: $3.2 Output: $12 20% 절약 |
GPT-6.1 Sol NEW openai / gpt-6.1-sol | OpenAI | — | Input: $4 Output: $15 | Input: $3.2 Output: $12 20% 절약 |
GPT-6 Luna NEW openai / gpt-6-luna | OpenAI | — | Input: $0.2 Output: $0.75 | Input: $0.16 Output: $0.6 20% 절약 |
Claude Opus 5 5 NEW anthropic / claude-opus-5-5 | Anthropic | — | Input: $4 Output: $20 | Input: $3.84 Output: $19.2 4% 절약 |
Claude Sonnet 5 5 NEW anthropic / claude-sonnet-5-5 | Anthropic | — | Input: $2 Output: $10 | Input: $1.92 Output: $9.6 4% 절약 |
Claude Haiku 5.5 NEW anthropic / claude-haiku-5-5 | Anthropic | — | Input: $0.5 Output: $2.5 | Input: $0.48 Output: $2.4 4% 절약 |
MiniMax M3 NEW minimax / MiniMax/MiniMax-M3 | MiniMax | — | Input: $0.6 Output: $2.4 | Input: $0.54 Output: $2.16 10% 절약 |
DeepSeek V4.1 Flash NEW deepseek / deepseek-v4-1-flash-260910 | DeepSeek | — | Off peak Input: $0.14 Off peak Output: $0.56 Peak Input: $0.28 Peak Output: $1.12 | Off peak Input: $0.084 Off peak Output: $0.336 Peak Input: $0.168 Peak Output: $0.672 40% 절약 |
GLM 5.3 NEW zhipu / glm-5.3 | Zhipu | — | Input: $1.4 Output: $4.4 | Input: $1.4 Output: $4.4 |
GPT Image 2.5 Sunburst NEW 이미지 openai / gpt-image-2.5-sunburst | OpenAI | Image | Text input: $5 / 1M tokens Image input: $8 / 1M tokens Image output: $30 / 1M tokens | Text input: $4.75 / 1M tokens Image input: $7.6 / 1M tokens Image output: $28.5 / 1M tokens 5% 절약 |
GPT Image 2.5 Flare NEW 이미지 openai / gpt-image-2.5-flare | OpenAI | Image | Text input: $5 / 1M tokens Image input: $8 / 1M tokens Image output: $30 / 1M tokens | Text input: $4.75 / 1M tokens Image input: $7.6 / 1M tokens Image output: $28.5 / 1M tokens 5% 절약 |
Gemini 3.5 Flash google / gemini-3.5-flash | — | Input: $1.5 Output: $9 | Input: $1.2 Output: $7.2 20% 절약 | |
GPT-5.6 Sol openai / gpt-5.6-sol | OpenAI | — | Input: $8 Output: $30 | Input: $6.4 Output: $24 20% 절약 |
GPT-5.6 Terra openai / gpt-5.6-terra | OpenAI | — | Input: $4 Output: $18 | Input: $3.2 Output: $14.4 20% 절약 |
GPT-5.6 Luna openai / gpt-5.6-luna | OpenAI | — | Input: $0.4 Output: $1.8 | Input: $0.32 Output: $1.44 20% 절약 |
Deepseek V4 Flash deepseek / deepseek-v4-flash | DeepSeek | — | Off peak Input: $0.22 Off peak Output: $0.66 Peak Input: $0.44 Peak Output: $1.32 | Off peak Input: $0.22 Off peak Output: $0.66 Peak Input: $0.44 Peak Output: $1.32 |
Deepseek V4 Pro deepseek / deepseek-v4-pro | DeepSeek | — | Off peak Input: $0.66 Off peak Output: $1.98 Peak Input: $1.32 Peak Output: $3.96 | Off peak Input: $0.66 Off peak Output: $1.98 Peak Input: $1.32 Peak Output: $3.96 |
Kimi K3 moonshot / kimi-k3 | Moonshot | — | Input: $3 Output: $15 | Input: $2.85 Output: $14.25 5% 절약 |
Qwen3.7 Plus alibaba / qwen3.7-plus | Alibaba | — | Input: $1.2 Output: $4.8 | Input: $0.96 Output: $3.84 20% 절약 |
Qwen3.7 Max alibaba / qwen3.7-max | Alibaba | — | Input: $2.5 Output: $7.5 | Input: $2 Output: $6 20% 절약 |
Qwen3.8 Max alibaba / qwen3.8-max | Alibaba | — | Input: $2 Output: $6 | Input: $2 Output: $6 |
Glm 5.2 zhipu / glm-5.2 | Zhipu | — | Input: $1.12 Output: $3.92 | Input: $0.952 Output: $3.332 15% 절약 |
Gemini 3 Pro Image 이미지 google / gemini-3-pro-image | Image | Input: $2 Output: $12 Image output: $120 | Input: $1.6 Output: $9.6 Image output: $96 20% 절약 | |
Gemini 3.1 Flash Image 이미지 google / gemini-3.1-flash-image | Image | Input: $0.5 Output: $3 Image output: $60 | Input: $0.4 Output: $2.4 Image output: $48 20% 절약 | |
Gpt Image 2 이미지 openai / gpt-image-2 | OpenAI | Image | Text input: $5 / 1M tokens Image input: $8 / 1M tokens Image output: $30 / 1M tokens | Text input: $4.75 / 1M tokens Image input: $7.6 / 1M tokens Image output: $28.5 / 1M tokens 5% 절약 |
Doubao Seedream 4 5 251128 이미지 bytedance / doubao-seedream-4-5-251128 | ByteDance | Image | Image: ¥0.25 / image | Image: ¥0.25 / image |
Seedance 2.0 비디오 bytedance / doubao-seedance-2-0-260128 | ByteDance | Video | 480p: ≈¥0.46 / 초 720p: ≈¥0.99 / 초 | 480p: ≈¥0.45 / 초 720p: ≈¥0.96 / 초 3% 절약 |
Seedance 2.0 Fast 비디오 bytedance / doubao-seedance-2-0-fast-260128 | ByteDance | Video | 480p: ≈¥0.37 / 초 720p: ≈¥0.80 / 초 | 480p: ≈¥0.36 / 초 720p: ≈¥0.78 / 초 3% 절약 |
Seedance 2.0 Mini 비디오 bytedance / doubao-seedance-2-0-mini-260615 | ByteDance | Video | 480p: ≈¥0.23 / 초 720p: ≈¥0.50 / 초 | 480p: ≈¥0.22 / 초 720p: ≈¥0.49 / 초 3% 절약 |
Seedance 2.5 비디오 bytedance / doubao-seedance-2-5-260628 | ByteDance | Video | 480p: ≈¥0.67 / 초 720p: ≈¥1.51 / 초 | 480p: ≈¥0.65 / 초 720p: ≈¥1.46 / 초 3% 절약 |
Grok Imagine Video 비디오 xai / grok-imagine-video | xAI | Video | 480p: $0.05 / 초 720p: $0.07 / 초 Reference image: $0.002 / image | 480p: $0.05 / 초 720p: $0.07 / 초 Reference image: $0.002 / image |
Grok Imagine 1.5 Video Apimart 비디오 xai / grok-imagine-1.5-video-apimart | xAI | Video | 480p: $0.05 / 초 720p: $0.07 / 초 Reference image: $0.002 / image | 480p: $0.05 / 초 720p: $0.07 / 초 Reference image: $0.002 / image |
Seedance 2.0 Mini (BytePlus) 비디오 bytedance / seedance-2.0-mini | ByteDance | Video | 480p: $0.04 / 초 720p: $0.08 / 초 | 480p: $0.0388 / 초 720p: $0.0776 / 초 3% 절약 |
Seedance 2.0 (BytePlus) 비디오 bytedance / seedance-2.0 | ByteDance | Video | 480p: $0.07 / 초 720p: $0.15 / 초 1080p: $0.37 / 초 4k: $0.78 / 초 | 480p: $0.0679 / 초 720p: $0.1455 / 초 1080p: $0.3589 / 초 4k: $0.7566 / 초 3% 절약 |
수동 설정
OpenAI 프로토콜을 지원하는 클라이언트라면 아래 네 가지 값만 넣으면 Octer 에 연결됩니다.
다른 사용법
선택하지 않은 나머지 두 가지 사용법은 여기에 모아 두었습니다. 같은 키를 그대로 쓸 수 있으니 필요할 때 펼쳐 보세요.
문제 해결
데이터에 대하여: 프롬프트와 참고 이미지는 결과 생성을 위해 Octer 게이트웨이로 전송됩니다. API 키는 요청 헤더로만 오가며 디스크에 기록되지 않습니다. 생성된 이미지와 영상은 사용자 기기에만 저장됩니다.