공식 E2X SDK
TypeScript, Python, Go를 위한 프로덕션급 오픈소스 SDK. 센트 미만 단위의 금융 정밀도와 오차 없는 마이크로센트 과금으로 10개 이상의 생성형 AI 모델을 하나의 통합 인터페이스로 호출할 수 있습니다.
3개 공식 런타임
TypeScript / Python / Go
마이크로센트 정밀도
$0.000001 오차 없는 과금
100% 타입 안전
완벽한 IDE 자동 완성 및 검증
런타임 오버헤드 제로
TS 및 Go 순수 표준 라이브러리 기반
브라우저, Node.js 18+, 그리고 엣지 런타임(Cloudflare Workers, Vercel Edge)을 위한 무의존성 범용 SDK. 엄격한 TypeScript 제네릭과 실시간 진행 상태 업데이트를 지원합니다.
npm install @e2x/sdkimport { E2X } from '@e2x/sdk';
const client = new E2X(); // reads E2X_API_KEY
const job = await client.run('google/nano-banana-pro', {
prompt: 'Neo Tokyo cyberpunk tiger, 8k cinematic render',
}, {
onUpdate: (snap) => console.log(`Progress: ${snap.progress}%`),
});
console.log('Result URL:', job.output?.outputs?.[0]?.url);
console.log(`Billed: $${job.cost_usd.toFixed(4)}`);네이티브 동기 및 비동기 클라이언트를 지원하는 Pydantic 검증 기반의 파이썬다운 SDK. 머신러닝 워크플로우, FastAPI 서비스, LangChain 파이프라인에 최적화되어 있습니다.
pip install e2xfrom e2x import E2X
client = E2X()
job = client.run(
"google/nano-banana-pro",
{"prompt": "Neo Tokyo cyberpunk tiger, 8k cinematic render"},
on_update=lambda j: print(f"Progress: {j.progress}%"),
)
print(f"URL: {job.output_urls[0]} | Cost: ${job.cost_usd:.4f}")Go
github.com/e2xai/e2x-go • Go 1.21+ / 순수 표준 라이브러리
외부 의존성 없이 오직 표준 라이브러리만으로 구축된 초경량 Go SDK. 스레드 안전한 클라이언트, context 기반 취소, 커스텀 언마샬링을 제공합니다.
go get github.com/e2xai/e2x-gopackage main
import (
"context"
"fmt"
"github.com/e2xai/e2x-go"
)
func main() {
ctx := context.Background()
client, _ := e2x.New() // reads E2X_API_KEY
job, _ := client.Run(ctx, e2x.RunParams{
Model: "google/nano-banana-pro",
Input: map[string]any{"prompt": "Neo Tokyo cyberpunk tiger"},
})
fmt.Println("Result:", job.OutputURL())
}통합 SDK 모노레포
세 가지 공식 E2X SDK는 모두 중앙 모노레포에서 관리되며, 통일된 테스트 스위트, 언어 간 기능 동등성 검증, 지속적 통합(CI) 및 단일 이슈 트래킹을 제공합니다.
TypeScript SDK • ESM/CJS 빌드 • Vitest 스위트 • 웹훅 검증기
Python SDK • Pydantic v2 스키마 • Pytest • 동기/비동기 HTTPX
Go SDK • 순수 표준 라이브러리 • 동시성 안전 • 외부 의존성 제로
E2X SDK 설계의 4대 핵심 원칙
모든 공식 E2X SDK는 동일한 아키텍처 명세를 준수하여 어떤 기술 스택에서도 일관된 동작, 예측 가능한 오류 처리, 감사 수준의 재무 정확성을 보장합니다.
마이크로센트 금융 정밀도
IEEE 754 부동소수점 반올림 오차가 전혀 없습니다. 모든 비용 회계는 정수 마이크로센트로 계산되어 비트 단위의 결정론적 잔액 추적을 보장합니다.
- 정확한 64비트 정수 연산으로 수백만 건의 요청에서도 소수점 센트 누적 오차를 완전히 제거합니다.
- 네이티브 이중 표현: SDK 모델은 정수형 cost_micro_cents와 포맷된 cost_usd를 모두 제공합니다.
- 클라이언트 영수증과 백엔드 원장 간 오차가 전혀 없는 감사 가능한 과금 기록을 제공합니다.
적응형 폴링 엔진
클라이언트 CPU를 소모하거나 업스트림 속도 제한을 유발하지 않으면서 1초 미만의 빠른 완료 결과를 즉시 전달하는 최적화된 2단계 폴링 루프입니다.
- 초기 버스트: 초고속 모델(텍스트-이미지 변환 등)을 위한 1초 주기의 고빈도 폴링.
- 장시간 실행 작업(비디오 렌더링, 다단계 업스케일)을 위한 2초 주기의 안정적 폴링으로 부드럽게 전환.
- 실시간 프론트엔드 상태 업데이트 및 로딩 바 구현을 위한 플러그형 onUpdate 진행 리스너 지원.
산업용 등급의 회복 탄력성
RFC 9110 Retry-After 헤더 파싱과 완전 비동기화된 무작위 지터(Full Jitter)가 결합된 지수 백오프를 통해 표준을 준수하는 HTTP 재시도 정책을 제공합니다.
- 일시적인 네트워크 끊김, HTTP 429 속도 제한 압박, 503 게이트웨이 오류를 안전하게 극복합니다.
- 분산된 백오프 곡선은 업스트림 모델 제공자에 대한 '썬더링 허드(Thundering Herd)' 재시도 폭주를 방지합니다.
- 모든 런타임에서 최대 재시도 횟수, 커스텀 타임아웃, 취소 토큰 연동을 자유롭게 설정할 수 있습니다.
암호화 HMAC-SHA256 웹훅
프로덕션급 비동기 작업 수집. 모든 웹훅은 타임스탬프가 포함된 원본 페이로드에 대해 암호화된 HMAC-SHA256 다이제스트로 인증됩니다.
- 서명된 페이로드 형식: {timestamp}.{raw_body} 구조는 페이로드 변조 및 중간자(MITM) 공격을 방지합니다.
- 엄격한 5분 재전송 허용 윈도우로 리플레이 공격과 오래된 패킷 주입을 원천 차단합니다.
- 타이밍 안전한 상수 시간(Constant-Time) 문자열 비교로 부채널 타이밍 분석 공격을 방어합니다.
3분 만에 개발 시작하기
API 키와 선호하는 프로그래밍 언어를 사용하여 공식 E2X SDK로 즉시 개발을 시작하세요.
계정 생성 및 API 키 발급
몇 초 만에 가입하고 개발자 설정에서 비밀 API 키를 생성하세요. 환경 변수에 E2X_API_KEY로 안전하게 보관하세요.
SDK 설치
TypeScript, Python 또는 Go 애플리케이션에 경량 패키지를 추가하세요. 모든 SDK는 무거운 의존성 없이 어디서나 실행됩니다.
추론 실행 및 비용 추적
원하는 모델 슬러그와 입력 파라미터로 client.run()을 호출하세요. 마이크로센트 정밀도, 실시간 상태 업데이트, 즉각적인 결과를 경험할 수 있습니다.