빠른 시작

API 키를 발급받고 최소 예시로 텍스트, 이미지 및 비디오 모델을 호출합니다.

API 키를 발급받고 최소 예시로 텍스트 대화, 이미지 생성 및 비디오 생성을 호출합니다.

1단계: 계정 만들기

계정은 AGTCloud에서 등록합니다. 기존 계정이 있으면 바로 로그인할 수 있습니다.

2단계: API 키 발급받기

API Keys로 이동합니다.
API 키 만들기를 클릭합니다.
API 키를 복사하여 안전하게 보관합니다.

API 키를 안전하게 보관하세요

브라우저 프런트엔드, 공개 저장소, 스크린샷 또는 로그에 전체 API 키를 저장하지 마세요. 유출이 의심되면 즉시 폐기해야 합니다.

API 키 메뉴, 생성 버튼 및 관리 영역이 표시된 AGTCloud API 키 관리 화면

3단계: 사용 가능한 잔액 확인하기

API 호출은 계정 잔액을 사용합니다. 요청 전에 잔액 및 충전 페이지에서 사용 가능한 잔액을 확인하세요. 충전 방법과 반영 결과는 콘솔 표시를 기준으로 합니다.

4단계: 첫 API 호출하기

아래 예시는 현재 사이트의 API 주소와 예시 모델을 사용합니다. 실제 호출 전에 모델 목록에서 현재 API 키로 해당 모델을 사용할 수 있는지 확인하세요.

LLM과 대화하기

Chat Completions 호환 API는 OpenAI SDK 또는 HTTP 요청으로 호출할 수 있습니다.

from openai import OpenAI

client = OpenAI(
    api_key="your-api-key",
    base_url="https://api.agtcloud.cn/v1",
)

response = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[
        {"role": "user", "content": "안녕하세요! 어떤 일을 할 수 있나요?"}
    ],
)

print(response.choices[0].message.content)

응답 텍스트는 choices[0].message.content에 있습니다. 다른 매개변수는 Chat Completions를 확인하세요.

이미지 생성하기

curl 'https://api.agtcloud.cn/v1/images/generations' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer your-api-key' \
  --data '{
    "model": "qwen-image",
    "prompt": "구름 바다 위에 떠 있는 미래 도시"
  }'

비디오 생성하기

curl 'https://api.agtcloud.cn/v1/video/generations' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer your-api-key' \
  --data '{
    "model": "doubao-seedance-2-5-260628",
    "prompt": "푸른 성운을 통과하는 우주선"
  }'

생성에 성공하면 응답의 task_id를 저장하고 작업 상태와 결과를 조회합니다:

curl 'https://api.agtcloud.cn/v1/video/generations/your-task-id' \
  -H 'Authorization: Bearer your-api-key'

전체 필드와 작업 상태는 비디오 만들기와 비디오 조회를 확인하세요.

운영 환경의 API 키 보호

your-api-key는 바꿔 넣을 위치를 표시하는 용도로만 사용합니다. 운영 프로젝트는 서버 환경 변수 또는 키 관리 서비스를 통해 API 키를 읽어야 합니다. 실제 키를 코드 저장소에 커밋하거나 브라우저 프런트엔드로 보내지 마세요.

브라우저에서 요청을 검증하려면 API 테스트를 열 수 있습니다.

5단계: 모델 살펴보기

작업에 적합한 모델은 모델 목록에서 찾습니다. 호출 전에 모델이 지원하는 프로토콜과 매개변수, 현재 계정의 권한을 확인하세요.

다음 단계

이미지 생성 — 이미지 생성 및 편집을 알아봅니다.
비디오 생성 — 비디오 작업 생성 및 조회를 알아봅니다.
오디오 처리 — 음성 합성, 전사 및 번역을 알아봅니다.
타사 통합 — 일반적인 개발 도구에서 AGTCloud를 연동합니다.
오류 및 문제 해결 — 일반적인 요청 오류를 해결합니다.

이 페이지의 내용