첫 API 요청 보내기

콘솔에서 API 키를 만들고 엔드포인트와 모델명을 설정하세요. Elysia API는 일본에 거주하는 개인이 운영하는 제3자 AI API 중계 서비스입니다.

1. 계정 및 API 키

계정 만들기에서 가입한 후 이메일 인증과 봇 방지 확인을 완료하세요. 로그인 후 API 키에서 새 키를 만드세요. 용도별로 키를 분리하고 필요한 그룹·모델·사용 한도를 설정하세요.

API 키는 비밀번호처럼 관리하세요. 브라우저에 공개되는 코드나 Git 저장소에 넣지 말고 서버의 환경 변수로 보관하세요.

2. 엔드포인트 및 모델

Base URL: https://api.elysia.earth/v1

모델 및 요금에서 API 키의 그룹으로 이용 가능한 모델을 선택하세요. 아래의 MODEL_ID를 선택한 정확한 모델명으로 바꾸고, 모델 상세 정보에서 지원 엔드포인트도 확인하세요. 일시 중단된 모델은 사용할 수 없습니다.

환경 변수 ELYSIA_API_KEY에 키를 저장한 후 실행하세요. 아래 예제는 Chat Completions를 지원하는 모델용입니다.

cURL

curl https://api.elysia.earth/v1/chat/completions \
  -H "Authorization: Bearer $ELYSIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "messages": [{"role": "user", "content": "안녕하세요"}],
    "max_tokens": 64
  }'

Python (OpenAI 호환 클라이언트)

pip install openai로 SDK를 설치하세요.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ELYSIA_API_KEY"],
    base_url="https://api.elysia.earth/v1",
)
response = client.chat.completions.create(
    model="MODEL_ID",
    messages=[{"role": "user", "content": "안녕하세요"}],
    max_tokens=64,
)
print(response.choices[0].message.content)

출력 한도 매개변수와 지원 기능은 SDK와 모델에 따라 다릅니다. 지원하지 않는 매개변수 오류가 발생하면 모델 상세 정보를 확인하세요.

3. 요금 및 사용 내역 확인

입력·출력·캐시 등의 사용량에 따라 미리 구매한 API 크레딧에서 차감됩니다. $ 표시는 사이트 내 API 크레딧입니다. 기본 구매 단가는 40엔 = API 크레딧 $1이며, 달러 환율이나 현금 잔액이 아닙니다. 결제 통화는 일본 엔화(JPY)입니다.

최신 요금과 긴 입력의 할증 조건은 요금 페이지에서 확인하세요. 요청 후 사용 내역에서 토큰·차감액을, 지갑에서 잔액·구매 내역을 확인할 수 있습니다.

연결에 문제가 있을 때

해결되지 않으면 hello@elysia.earth로 모델명·발생 시각·오류 내용을 알려 주세요. API 키, 비밀번호, 입력한 기밀 정보는 보내지 마세요. 기본 문의 대응 언어는 일본어입니다.