개발자 API · 공개 REST

서버를 띄우고,
코드를 실행하세요.

콘솔에서 클릭으로 하던 일을 전부 REST API로. 토큰 하나로 당신의 프로그램이나 코딩 에이전트가 팟·DB·코드 샌드박스를 직접 띄우고 지워요.

OpenAPI 스펙 공개 · 스코프 키로 최소권한 발급 · 로그인 없이 둘러보기

terminal

# 팟(서버/GPU) 하나 띄우기
$ curl -X POST https://api.onpod.ai/v1/pods \
    -H "Authorization: Bearer $ONPOD_TOKEN" \
    -d '{"gpu":"cpu_small","image":"nginx"}'

{ "id": "pod_a1b2c3", "state": "creating",
  "url": "https://swift-otter-742.onpod.ai" }

# 잘 떴는지 확인
$ curl https://api.onpod.ai/v1/pods/pod_a1b2c3 \
    -H "Authorization: Bearer $ONPOD_TOKEN"

이런 게 코드로 돼요

하나의 API 키로 콘솔의 거의 모든 기능을 호출해요. AI 에이전트한테 맡기면 자연어로도 같은 일을 해줘요.

팟·앱 배포

GPU·CPU 팟 생성, 앱 배포·자동 확장·커스텀 도메인 연결까지 코드로.

관리형 Postgres

DB 생성·백업·복구·자동 확장. 무료 Dev 플랜부터.

코드 샌드박스

AI 에이전트가 코드를 클론·테스트·실행할 임시 격리 환경. e2b 국산 대체.

백업 · 보관함

체크포인트 자동 백업, 공유·데이터 디스크를 API 로 관리.

웹사이트 · 도메인

정적 사이트 배포와 커스텀 도메인·인증서를 프로그래밍으로.

결제 · 키 · 잔액

사용량·잔액 조회, 스코프 키 발급·회수로 최소권한 통합.

빠른 시작

가입하고 키만 받으면 바로 첫 호출. 아래 두 줄을 그대로 복사해서 토큰만 넣으면 돼요.

API 키 발급

5초 가입 후 콘솔 API 키 페이지에서 토큰을 받아요. 통합엔 전권 대신 opk_ 스코프 키로 최소권한(리소스별 read/write·만료)을 주세요.

첫 호출 — 토큰 확인

모든 요청은 Authorization: Bearer 헤더가 필요해요(version·openapi.json 제외).

더 깊이 — SDK·에이전트

OpenAPI 스펙 으로 SDK를 자동 생성(codegen)하거나 Postman에 바로 임포트하세요. 코딩 에이전트(Claude Code·Codex)는 전체 API를 자동으로 인지해 호출해요.

bash

# 토큰을 환경변수로
export ONPOD_TOKEN=opk_live_…

# 1) 내 토큰 확인
curl https://api.onpod.ai/v1/whoami \
  -H "Authorization: Bearer $ONPOD_TOKEN"

# 2) 쓸 수 있는 컴퓨트·가격 보기
curl https://api.onpod.ai/v1/gpus \
  -H "Authorization: Bearer $ONPOD_TOKEN"

# 3) 내 팟·앱 목록
curl https://api.onpod.ai/v1/pods \
  -H "Authorization: Bearer $ONPOD_TOKEN"

엔드포인트 레퍼런스

아래 목록은 라이브 OpenAPI 스펙에서 바로 가져온 거예요 — 항상 최신. 요청·응답 본문 스키마는 /v1/openapi.json 에 들어 있어요. 공개 표시는 인증 없이 호출돼요.

불러오는 중…

서버를 띄우고,코드를 실행하세요.