ShareAI Platform Docs

비디오 생성

제출 시 HTTP 202와 ShareAI 작업 ID 및 폴링 URL을 반환합니다.

Markdown으로 보기
이 페이지에서
POST https://api.shareai.now/api/v1/videos

비디오 생성

기본 URL
https://api.shareai.now
인증
Bearer API 키 또는 승인된 OAuth 액세스 토큰
필수 범위
inference or monetization_gateway

제출은 HTTP 202를 반환하며 ShareAI 작업 ID와 폴링 URL을 제공합니다. 안정적인 Idempotency-Key 헤더를 사용하여 동일한 요청을 재시도하십시오. 다른 입력으로 해당 키를 재사용하면 거부됩니다. 폴링은 GET /api/v1/videos/{id} 동일한 원본 자격 증명을 사용합니다. 상태에는 대기 중, 보류 중, 진행 중, 마무리 중, 완료됨, 실패 및 검토 필요가 포함됩니다. 검토 필요 결과는 팀 조정이 필요하며, 폴링은 다른 생성을 시작하지 않습니다.

시작하기 전에#

서버에서 SHAREAI_API_KEY를 설정하고 모델 자리 표시자를 현재 활성화된 모델로 교체하세요. API 키를 브라우저 코드에 노출하지 마세요. 모델, 계정, 자격 증명 및 제공자가 모두 이 작업을 허용해야 합니다. 아래의 선택적 설정은 모델 지원이 필요합니다. API 안전 한도는 모든 모델이 모든 값을 지원한다는 보장이 아닙니다.

요청 보내기#

cURL

curl --fail-with-body --request POST "https://api.shareai.now/api/v1/videos" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
  --data '{
  "model": "YOUR_ENABLED_VIDEOS_MODEL",
  "prompt": "A slow camera move through a quiet forest.",
  "duration": 8
}'

요청 필드#

필드유형의미와 제한
model 필수문자열정확히 활성화된 공개 모델 식별자. 이 작업을 선언하고 귀하의 자격 증명으로 허용되어야 합니다.
prompt 필수문자열비어 있지 않은 생성 프롬프트, 최대 256 KiB의 UTF-8 텍스트.
duration정수선택적으로 요청된 비디오 길이는 초 단위로 1–600이며, 선택한 모델에 따라 추가로 제한됩니다. 실제 반환된 길이에 따라 길이 청구가 결정됩니다.
resolution문자열모델 지원 해상도 선택기, 최대 100자; 게시된 요금제 변형과 일치해야 합니다.
aspect_ratio문자열모델 지원 화면 비율 선택기, 최대 100자.
size문자열모델 지원 출력 크기, 최대 100자, 예: 1024×1024. 모든 모델이 이 옵션을 지원하는 것은 아닙니다.
generate_audio불리언선택적 비디오 사운드트랙 선택기. 모델 지원과 일치하는 요금제 변형이 필요합니다.
seed정수선택적 모델 지원 시드. 비디오는 0 이상의 정수를 요구하며, 재현 가능성은 실행자에 따라 달라집니다.
frame_images배열최대 두 개의 image_url 부분, 각각 frame_type이 first_frame 또는 last_frame으로 중복 없이 설정됩니다. frame_images와 input_references를 결합하지 마십시오.
input_references배열최대 16개의 유형화된 image_url 부분, image_url.url이 HTTPS URL 또는 지원되는 이미지 데이터 URL로 설정됩니다. 모델 지원이 필요합니다.
provider객체선택적 공급자 라우팅 선호도. 모델 ID의 접두사가 아닌, 허용된 공급자 태그에 대해 provider.only를 사용하십시오. 계정 및 자격 증명 제한은 여전히 적용됩니다.
allow_temporary_retention불리언비디오 전용. 명시적으로 true를 설정하면 임시 업스트림 결과 보관이 필요한 경로에서 이를 허용합니다. 생략/false는 해당 경로를 사용할 수 없게 유지합니다. provider.zdr:true와 충돌하며, 다른 작업은 필수 ZDR을 유지합니다.

결과 읽기#

성공 시 HTTP 202와 JSON을 반환합니다. 제출은 HTTP 202를 반환하며 ShareAI 작업 ID와 폴링 URL을 제공합니다. 안정적인 Idempotency-Key 헤더를 사용하여 동일한 요청을 재시도하십시오. 다른 입력으로 해당 키를 재사용하면 거부됩니다. 폴링은 GET /api/v1/videos/{id} 동일한 원본 자격 증명을 사용합니다. 상태에는 대기 중, 보류 중, 진행 중, 마무리 중, 완료됨, 실패 및 검토 필요가 포함됩니다. 검토 필요 결과는 팀 조정이 필요하며, 폴링은 다른 생성을 시작하지 않습니다.

청구 단위#

비디오 경로는 청구 단위를 선언합니다. 초 단위 경로는 반환된 각 파일의 측정된 길이를 사용하여 정산하며, 요청된 길이나 업스트림 USD 비용을 사용하지 않습니다. 요청된 길이는 1초에서 600초 사이여야 하며 모델에서 지원되어야 합니다. 보수적인 신용 보류는 최대 네 개의 출력을 커버할 수 있습니다.

Console에서 정확히 활성화된 모델 식별자를 선택하세요. 선언된 작업 및 입출력 기능이 이 엔드포인트와 일치해야 합니다. 텍스트 채팅 모델은 다른 작업으로 대체될 수 없습니다. 자격 증명, 제공자 및 계정 제한은 여전히 적용됩니다.

가격 및 사용량#

요금은 선택된 모델, 제공자, 단위 및 변형에 대해 EUR AI 크레딧으로 게시됩니다. 활성 요금제의 차원만 청구됩니다. 실행 전에 크레딧을 예약하는 견적이 제공되며, 최종 청구는 측정된 사용량을 기준으로 합니다. 가격은 해상도, 출력 형식 또는 사용량 대역에 따라 달라질 수 있습니다. 최종 ShareAI 차감액은 Console Usage에서 확인하세요. 상류 비용 필드와 미디어 바이트는 발명된 토큰 수로 변환되지 않습니다.

접근 및 오류#

사용 inference 승인된 네트워크 비용 추론의 경우 monetization_gateway 승인된 Builder 마크업 및 수락된 청구 조건의 경우. 신원 확인만으로는 지출이 승인되지 않습니다. 유효성 검사, 모델 승인, 크레딧 부족, 속도 제한 및 실행 실패는 구조화된 error. 를 반환합니다. 타임아웃 또는 불확실한 제출 후에는 또 다른 잠재적으로 유료 요청을 생성하기 전에 Usage 또는 비디오 작업을 확인하세요.

임시 비디오 보관#

일부 비디오 경로는 생성된 결과를 검색할 수 있도록 임시 업스트림 보관이 필요합니다. 해당 비디오 요청에 대해 명시적으로 allow_temporary_retention:true 수락해야 합니다. 이를 생략하면 해당 경로를 사용할 수 없게 됩니다. 이 예외는 비디오에만 적용되며 다른 작업에 대한 모델 학습이나 보관을 절대 허용하지 않습니다. 명시적인 ZDR 정책은 암묵적으로 약화될 수 없습니다.

JSON

{"allow_temporary_retention": true}

작업 상태 확인#

GET https://api.shareai.now/api/v1/videos/{id}

원본 자격 증명을 사용하여 비디오 생성을 읽으십시오.

기본 URL
https://api.shareai.now
인증
Bearer API 키 또는 승인된 OAuth 액세스 토큰
필수 범위
inference or monetization_gateway

JSON

{
  "id": "YOUR_JOB_ID",
  "object": "video",
  "status": "pending",
  "created_at": 1793664000,
  "polling_url": "/api/v1/videos/YOUR_JOB_ID"
}

위 JSON은 안정적인 작업 필드를 보여주며 실제 생성은 아닙니다. 동일한 키로 ShareAI 경로를 폴링하며, 확인 사이에 대기합니다. 대기 중, 보류 중, 진행 중 및 마무리 중은 대기를 의미하며, 완료됨은 ShareAI 콘텐츠 URL로 데이터를 노출합니다. 실패 및 검토 필요는 중지하고 점검해야 합니다. 일시적인 오류 후 상태를 다시 읽을 수 있지만 생성을 자동으로 다시 제출하지 마십시오. 다른 자격 증명이나 취소된 자격 증명은 작업을 검색할 수 없습니다.

cURL

curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID" \
  -H "Authorization: Bearer $SHAREAI_API_KEY"

결과 다운로드#

완료되면 각 데이터 항목에는 ShareAI 콘텐츠 URL이 포함됩니다. 가져오기 GET /api/v1/videos/{id}/content?index=0 동일한 원본 자격 증명을 사용하여. 해당 엔드포인트는 단일 HTTP 바이트 범위를 지원합니다. Provider URL, 비공개 티켓 및 Provider 자격 증명은 반환되지 않습니다. 폴링 및 다운로드는 추가 추론 요청이나 Monetization Gateway 수수료를 발생시키지 않습니다. 작업이 완료되었다는 것은 파일 다운로드 가능 상태가 되기 전에 정산이 확인되었음을 의미합니다.

cURL

curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID/content?index=0" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" --output result.mp4

선택적 frame_images는 first_frame 또는 last_frame이 포함된 image_url 부분을 포함해야 합니다. 하나의 요청에서 frame 이미지 또는 참조 이미지를 사용해야 하며, 둘 다 사용할 수는 없습니다. 모델의 지속 시간, 해상도 및 화면 비율은 API의 안전 범위보다 더 제한적일 수 있습니다. Webhooks 및 임의의 콜백 URL은 지원되지 않습니다.

마지막 업데이트 2026년 11월 3일

ShareAI 플랫폼 문서
모든 문서

제목 또는 내용으로 검색하세요.

이 페이지에 대해 문의하기

이 페이지를 탐색할 도우미를 선택하세요. 페이지를 복사하여 대화에 붙여넣을 수도 있습니다.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI