Graydient AI 렌더링 API
앱, 내부 도구 또는 렌더 파이프라인을 구축할 때 Graydient는 전용 GPU에서 오픈 이미지, 비디오, LLM 모델을 하나의 API로 정액 요금에 제공합니다.
포함된 요금제
개인 API는 Video Max에만 포함됩니다: 연간 결제 시 월 $84 ($999 연간 청구) 또는 월별 $99.99. Images와 Video Plus는 API 접근을 포함하지 않습니다. 청구 포털에서 언제든 업그레이드, 다운그레이드, 취소 가능하며 비례 청구됩니다.
개인 API 키는 한 사용자용이며 재판매 금지입니다. 호출 제한이 있어 약 10초에 한 번 호출을 권장하며 배치 호출은 피하세요. 요청이 너무 많으면 키가 자동 만료될 수 있습니다.
다중 사용자 또는 화이트 라벨 제품 구축
가상 사용자 및 화이트 라벨 로그인은 다수 사용자를 위한 비즈니스급 기능입니다. 개인 API에서 작동하므로 개발 중 Video Max에서 다중 사용자 및 화이트 라벨 흐름을 구축하고 테스트할 수 있습니다.
다중 사용자 제품 출시나 접근권 재판매는 비즈니스급 옵션이 필요합니다: 전용 GPU 서버 또는 비즈니스 계약. 비즈니스 배포 상담은 info@graydient.ai으로 문의하세요.
| 개인 API (Video Max) | 비즈니스 배포 | |
|---|---|---|
| 사용자 | 한 명의 사용자 (당신) | 당신 제품의 사용자들 |
| 재판매 | 허용되지 않음 | 허용됨 |
| 가상 사용자 및 화이트라벨 로그인 | 빌드 및 테스트 | 실서비스 |
| 획득 방법 | Video Max 구독 | 전용 GPU 서버 또는 비즈니스 계약 |
API 작동 방식
현재 버전은 V3이며, https://cloud.graydient.ai/api/v3/에 있습니다. JSON:API 사양을 따릅니다: application/vnd.api+json을 보내고 받고, API 토큰 페이지에서 받은 표준 HTTP Bearer 토큰으로 인증하며, attributes 멤버가 있는 data 객체에서 결과를 읽습니다.
렌더링은 비동기식입니다. 프롬프트와 필수 callback_url을 포함해 POST /api/v3/render/에 POST합니다. Graydient는 즉시 render_hash와 예상 대기 및 렌더 시간을 응답합니다. 작업이 완료되면 결과를 웹훅으로 POST합니다. 선택적 필드는 다음과 같습니다:
- error_url: 실패 시 웹훅
- init_image 및 mask_image: 이미지 변환 및 인페인팅용
- placeholders: ControlNet 모드 또는 IP 어댑터용 명명된 이미지 URL
- progressive_return: 이미지별 콜백 하나씩
- session_id: 렌더를 자체 사용자와 연동
워크플로우는 프롬프트 내 워크플로우 명령어로 같은 엔드포인트를 통해 실행됩니다.
폴링 없이 상태 확인: GET GET /api/v3/render/{render_hash}는 렌더 상태를 반환하지만 문서에서는 폴링을 권장하지 않습니다. 웹훅이나 wss://cloud.graydient.ai/render-events/{render_hash}의 WebSocket 스트림을 사용하세요. 시작, 이미지 완료, 완료 및 오류 이벤트를 전송합니다.
다른 엔드포인트 종류
- 채팅: 페르소나가 있는 LLM 채팅. 응답은 콜백으로 가거나 sync: true와 함께 인라인으로 돌아오며, 비전 모델은 image_url을 받습니다.
- 컨셉: 사용 가능한 모델과 LoRA 목록.
- 워크플로우: 워크플로우 목록과 txt2img, img2img, txt2vid, img2vid 같은 지원 기능.
- 지식 베이스: 도메인 생성, 사실 추가, URL 크롤링 후 검색 또는 채팅.
- 스킬: 자연어 요청을 워크플로우 명령어로 변환.
- 가상 사용자: 최종 사용자를 계정 내 기록에 매핑. 개인 API에서 빌드 및 테스트 후 비즈니스 배포에서 실서비스.
전체 참조: API 문서. 문서에 따르면 아직 개발 중입니다.
일반적인 사용 사례
- 자체 앱 구동: 이미지, 비디오 또는 채팅 기능의 렌더 백엔드로 Graydient 사용. 개인 API에서 개발 후 실제 사용자 도착 시 비즈니스 배포로 이동.
- 호스팅 모델 사용: 설치한 LoRA와 체크포인트로 렌더링. 자세한 내용은 자신만의 AI 모델 호스팅 참조.
- ComfyAPI 스타일 워크플로우를 원격으로 실행: 자신의 코드에서 매핑된 워크플로우를 호출하세요.
- 제품 및 카탈로그 이미지: 개인 API의 속도 제한 내에서 파이프라인에서 이미지 업스케일, 편집 또는 스타일 변경.
- 배치 렌더링: 지속적이고 대량 배치에는 개인 API 대신 전용 GPU 서버 사용.
- 지식 베이스 채팅: 지식 베이스와 채팅 엔드포인트로 지원 또는 문서 도우미 구축.
전용 GPU 서버
다중 사용자 제품 운영, API 액세스 재판매 또는 하루 종일 배치 렌더링 계획 시 Graydient는 월 $499.99에 전용 Video Max GPU 서버를 제공합니다. 대기열 없이 전용 머신을 사용하며, 더 긴 작업 실행과 고객별 제한 설정 가능. 성장에 따라 여러 서버 추가 가능하며, 계약은 30일 사전 통보 필요, 장기 약정 없음.
전용 서버 렌더링 가격: 전용 서버에서 렌더링은 각각 $0.02이며 비디오 포함. 이 가격은 전용 서버에만 적용됩니다. Images, Video Plus, Video Max 플랜은 고정 요금제로 렌더링당 요금 없음.
대여 문의는 info@graydient.ai으로 연락하세요.
시작하기
- Video Max 구독. 언제든 청구 포털에서 플랜 변경 또는 취소 가능.
- API 토큰 페이지에서 토큰 생성.
- API 문서를 읽고 GitHub에서 Graydient API 예제 확인.
- 웹훅 엔드포인트 설정 후 첫 렌더 요청 전송.
- 문서 권장대로 결과 이미지 미러링 및 썸네일 생성 후 사용자에게 제공.
API 지원은 info@graydient.ai 이메일로 가능. 모든 사용은 허용 사용 정책 및 이용 약관에 따름.