비디오 준비 중
Avala 시작하기
5-6분 — API 키 설정, SDK 설치, 첫 번째 API 호출
사전 요구 사항: Avala 계정이 필요합니다. avala.ai에서 가입하거나 SDK로 프로그래밍 방식으로 생성한 후(아래 참조), **설정 > 보안**에서 API 키를 생성하세요.
from avala import Client
client = Client(api_key="avk_your_api_key")
for dataset in client.datasets.list():
print(dataset.name, dataset.item_count)
이것으로 끝입니다. 아래는 무슨 일이 일어나고 있는지와 다음에 할 수 있는 것에 대한 단계별 안내입니다.
계정 생성
avala.ai에서 가입하거나 프로그래밍 방식으로 계정을 생성할 수 있습니다. SDK signup 함수는 API 키가 필요 없으며 성공 시 반환합니다.
from avala import signup
result = signup(email="dev@acme.com", password="SecurePass123!")
print(f"API Key: {result.api_key}")
API 키 받기
- Mission Control에 로그인합니다.
- **설정 > 보안**으로 이동합니다.
- API 키 생성을 클릭하고, 이름을 지정하고, 범위를 선택하고, 키를 복사합니다.
API 키는 생성 시에만 표시됩니다. 대화 상자를 닫기 전에 안전한 곳에 저장하세요.
환경 변수로 설정하면 모든 SDK와 CLI가 자동으로 인식합니다:
export AVALA_API_KEY="avk_your_api_key"
데이터셋 목록
from avala import Client
client = Client() # 환경에서 AVALA_API_KEY 읽기
for dataset in client.datasets.list():
print(f"{dataset.name} — {dataset.item_count} items")
프로젝트 목록
for project in client.projects.list():
print(f"{project.name} ({project.status})")
내보내기 생성
export = client.exports.create(project="proj_uid_here")
print(f"Export {export.uid}: {export.status}")
내보내기는 비동기적으로 실행됩니다. client.exports.get(uid) 또는 avala exports get <uid>로 완료될 때까지 상태를 폴링하세요.
다음 단계
Python SDK
비동기 지원, 페이지네이션, 오류 처리, 완전한 타입 힌트.
TypeScript SDK
의존성 없음. Node.js, Deno, Bun에서 작동.
CLI 레퍼런스
터미널에서 데이터셋, 프로젝트, 내보내기, 스토리지를 관리하세요.