창조 및 복구
세 제품 모두 하나의 Creations API를 사용하여 비디오, 이미지 및 앱 결과가 동일한 목록, 세부 사항 및 출력 작업 흐름을 공유합니다.
출처 파일 업로드
모든 제품은 input_file_ids를 수락합니다. 먼저 파일을 업로드하십시오 :
curl -s "https://api.kpainter.ai/openapi/v1/files" \ -H "Authorization: Bearer $KPAINTER_API_KEY" \ -F "file=@./handbook.pdf"예제 응답 :
{ "file_id": "file_xxx", "name": "handbook.pdf", "mime_type": "application/pdf", "size_bytes": 248391}반환된 파일_ID를 동일한 계정에 속하는 창조물 내에서만 사용하십시오.
만들기
POST /creations일반적인 영역 :
| 필드 | 필요성 | 의미 |
|---|---|---|
| 유형 | 예 예 | 비디오, 이미지 또는 앱 |
| 빠른 | 예 예 | 무엇을 만들 수 있는가 |
| 지침 | 아니오 | 추가 요구 사항 |
| 입력_file_ids | 아니오 | 이전에 업로드한 출처 ID |
| max 신용 | 아니오 | 이 작업을 위해 허용되는 최대 크레딧 |
| 비디오 / 이미지 / 앱 | 예 예 | 정확히 하나의 설정 개체와 일치하는 유형 |
예를 들어 :
{ "type": "app", "prompt": "Build a safety quiz with immediate feedback from the handbook", "input_file_ids": ["file_xxx"], "app": { "language": "en" }}리스트 및 얻기
GET /creations?page=1&page_size=20GET /creations?type=video&page=1&page_size=20GET /creations/{id}유용한 세부 사항 필드 :
| 필드 | 의미 |
|---|---|
| 상태 | 계획, 생산, 휴식, 준비 또는 실패 |
| 진보 / PCT | 0에서 100까지의 단조로운 진보 |
| 추정_remining_seconds | 신뢰할 수 있는 경우에만 존재한다. |
| 신용 - 신용 추정 | 이 작업에 대한 현재 추정치 |
| 실제 신용 | 성공적인 작업을위한 순 크레딧 |
| 사용 가능 - 배달 | 사용 가능한 결과가 이미 존재하는지 여부 |
| 액세서리_Actions | 현재 안전하게 전화를 받을 수 있는 행동 |
| 리뷰 | 안전한 설명기 비디오 출력, 사용할 수 있는 경우 |
| 결과 코드 | 사용자 안전한 결과 코드 |
일반적인 실패는 실제 신용을 놓치지 않습니다. 믿을 수 없는 ETA는 추측하는 대신 무시됩니다.
출구 읽기
GET /creations/{id}/outputs밖으로 돌아온 출력만 표시됩니다. URL을 입력하거나 끝없는 중간 문서를 사용하지 마십시오.
안정적인 고객 흐름
- 능력을 읽으세요.
- 유효한 창조 요청을 제출합니다.
- 몇 초마다 동일한 창조를 뿌리십시오.
- 준비가 되면 출구를 읽으십시오.
- 멈추면 사용자 액션을 표시하고 필요한 사용자 액션을 기다립니다.
- 실패하면 안전한 이유를 표시하고 사용자가 요청을 검토하도록하십시오.
- 네트워크 상태가 불확실하다면, 다른 하나를 만들기 전에 기존 창조를 얻으십시오.