{"doc":{"category_id":null,"content":"# 火山引擎(方舟) (Volcengine) 原生接口说明\n\n若客户端已使用火山引擎(方舟)请求路径，将 Base URL 指向本平台并使用本平台 API 密钥即可，无需改写为 OpenAI 格式。\n\n### 1. 原生聊天与对话 (Chat & Responses)\n* **对话端点**: `/api/v3/chat/completions`\n* **原生响应端点**: `/api/v3/responses`\n* **请求方式**: `POST`\n\n支持火山引擎(方舟) Request Payload。参数规范见 [火山引擎(方舟)官方文档](https://www.volcengine.com/docs/82379/1298454)。[聊天与响应 API](https://www.volcengine.com/docs/82379/1298454)\n\n### 2. 原生生图接口 (Image Generations)\n* **端点**: `/api/v3/images/generations`\n* **请求方式**: `POST`\n\n推荐极速版 `doubao-seedream-5-0-flash-260915` 或精细版 `doubao-seedream-5-0-pro-260628`（均支持单图高精度、图层拆分 `layer_decomposition`、透明通道 `background`）。**注意：Flash 与 Pro 均仅支持单图，不支持组图与 `sequential_image_generation`（严禁配置，否则报错）**；组图需求请使用 `doubao-seedream-5-0-260128`。场景 Body 见「doubao-seedream 图像生成」。[图片生成 API](https://www.volcengine.com/docs/82379/1541523)\n\n### 3. 原生视频生成任务 (Video Studio)\n* **提交任务**: `/api/v3/contents/generations/tasks` (`POST`)\n* **任务状态查询**: `/api/v3/contents/generations/tasks/{task_id}` (`GET`)\n* **取消/删除任务**: `/api/v3/contents/generations/tasks/{task_id}` (`DELETE`)\n* **列出任务历史**: `/api/v3/contents/generations/tasks` (`GET`)\n\n推荐 `doubao-seedance-2-5`。`content` 的 `role`：`first_frame` / `last_frame` / `reference_image` / `reference_video` / `reference_audio`。[视频生成 API](https://www.volcengine.com/docs/82379/1520757)\n\n2.5：时长 `4`–`30` 或 `-1`；全模态用 `omni_reference_task_type`（`auto`/`edit`/`extend`）；`output_format` 为 `mp4`/`mov`。编辑须 `ratio=adaptive` 且 `duration=-1`；首帧/延长须 `ratio=adaptive`。各场景 Body 见「Seedance 视频生成」。2.0 等旧模型见该文文末。\n\n```json\n{\n  \"model\": \"doubao-seedance-2-5\",\n  \"content\": [\n    {\"type\": \"text\", \"text\": \"参考图中角色走在雨后街道\"},\n    {\"type\": \"image_url\", \"image_url\": {\"url\": \"https://example.com/ref.png\"}, \"role\": \"reference_image\"}\n  ],\n  \"resolution\": \"720p\",\n  \"ratio\": \"16:9\",\n  \"duration\": 8,\n  \"generate_audio\": true\n}\n```\n\n### 4. 语音合成接口 (TTS)\n* **事件流模式 (SSE)**: `/api/v3/tts/unidirectional/sse` (`POST`)\n* **非流式 HTTP 模式**: `/api/v3/tts/unidirectional` (`POST`)\n\n请求头需采用火山原生的 `X-Api-Key: sk-your_token` 形式，模型可用 `X-Api-Resource-Id` 头指定或写在 `model` 请求体中。网关将返回火山标准的 JSON 数据（包含 Base64 编码的音频帧）。\n\n### 5. 多模态向量化接口 (Multimodal Embeddings)\n* **端点**: `/api/v3/embeddings/multimodal` (`POST`)\n\n兼容火山引擎(方舟)原生 Request Payload，支持图文多模态特征向量提取，网关对多模态 token 分布（文本 token 与图片 token）进行高精度独立计费。\n\n\n","created_at":"2026-07-06T09:45:24.384Z","id":11,"is_active":1,"is_dir":0,"is_preset":1,"parent_id":10,"slug":"volcengine-api","sort_order":10,"title":"火山方舟原生接口","translations":{"en":{"content":"# Volcengine Ark Native API Guide\n\nIf your client already uses Volcengine Ark request paths, point the Base URL to this platform and use your platform API Key—no need to rewrite payloads to OpenAI format.\n\n### 1. Native Chat & Responses\n* **Chat Endpoint**: `/api/v3/chat/completions`\n* **Native Responses Endpoint**: `/api/v3/responses`\n* **Request Method**: `POST`\n\nSupports Volcengine Ark Request Payload. For parameter specifications, see the [Volcengine Ark Official Documentation](https://www.volcengine.com/docs/82379/1298454). [Chat & Responses API](https://www.volcengine.com/docs/82379/1298454)\n\n### 2. Native Image Generation (Image Generations)\n* **Endpoint**: `/api/v3/images/generations`\n* **Request Method**: `POST`\n\nPrefer fast edition `doubao-seedream-5-0-flash-260915` or precision edition `doubao-seedream-5-0-pro-260628` (both support single image, layer split `layer_decomposition`, and alpha `background`). **Note: Both Flash and Pro support single images only (sequential_image_generation / group generation is strictly unsupported)**; for group generation use `doubao-seedream-5-0-260128`. Scene bodies are in the doubao-seedream image article. [Image API](https://www.volcengine.com/docs/82379/1541523)\n\n### 3. Native Video Generation Tasks (Video Studio)\n* **Submit Task**: `/api/v3/contents/generations/tasks` (`POST`)\n* **Query Task Status**: `/api/v3/contents/generations/tasks/{task_id}` (`GET`)\n* **Cancel/Delete Task**: `/api/v3/contents/generations/tasks/{task_id}` (`DELETE`)\n* **List Task History**: `/api/v3/contents/generations/tasks` (`GET`)\n\nPrefer `doubao-seedance-2-5`. `content.role`: `first_frame` / `last_frame` / `reference_image` / `reference_video` / `reference_audio`. [Video API](https://www.volcengine.com/docs/82379/1520757)\n\n2.5: duration `4`–`30` or `-1`; set `omni_reference_task_type` (`auto`/`edit`/`extend`); `output_format` is `mp4`/`mov`. Edit needs `ratio=adaptive` and `duration=-1`; first-frame/extend need `ratio=adaptive`. Scene bodies are in the Seedance video article. 2.0 and earlier are at the end of that page.\n\n```json\n{\n  \"model\": \"doubao-seedance-2-5\",\n  \"content\": [\n    {\"type\": \"text\", \"text\": \"The character from the image walks down a rainy street\"},\n    {\"type\": \"image_url\", \"image_url\": {\"url\": \"https://example.com/ref.png\"}, \"role\": \"reference_image\"}\n  ],\n  \"resolution\": \"720p\",\n  \"ratio\": \"16:9\",\n  \"duration\": 8,\n  \"generate_audio\": true\n}\n```\n\n### 4. Text-to-Speech API (TTS)\n* **Event Stream Mode (SSE)**: `/api/v3/tts/unidirectional/sse` (`POST`)\n* **Non-streaming HTTP Mode**: `/api/v3/tts/unidirectional` (`POST`)\n\nUse header `X-Api-Key: sk-your_token`. Model may be set via `X-Api-Resource-Id` or the `model` field in the body. Response is Volcengine-style JSON (base64 audio frames).\n\n### 5. Multimodal Embeddings API\n* **Endpoint**: `/api/v3/embeddings/multimodal` (`POST`)\n\nFully supports Volcengine Ark Request Payload for multimodal feature vector extraction, with fine-grained separate billing for text and image token usage.\n\n\n","title":"Ark Native API"},"ja":{"content":"# Volcengine Ark (火山方舟) ネイティブ API 説明\n\nクライアントがすでに Volcengine Ark のパスを使用している場合は、Base URL を本プラットフォームに向け、API キーを本プラットフォームのものに差し替えるだけで利用できます。\n\n### 1. ネイティブチャットと対話 (Chat & Responses)\n* **対話エンドポイント**: `/api/v3/chat/completions`\n* **ネイティブレスポンスエンドポイント**: `/api/v3/responses`\n* **リクエストメソッド**: `POST`\n\nVolcengine Ark ネイティブの Request Payload の完全なパススルーをサポートしています。パラメータの仕様については、[Volcengine Ark 公式ドキュメント](https://www.volcengine.com/docs/82379/1298454)をご参照ください。\n\n### 2. ネイティブ画像生成 API (Image Generations)\n* **エンドポイント**: `/api/v3/images/generations`\n* **リクエストメソッド**: `POST`\n\nArk のテキストからの画像生成 API と完全に一致しており、画像の縦横比の指定、プロンプトのスマート書き換え、ウォーターマークなどのネイティブパラメータをサポートしています。\n\n### 3. ネイティブ動画生成タスク (Video Studio)\n* **タスクの送信**: `/api/v3/contents/generations/tasks` (`POST`)\n* **タスクステータス確認**: `/api/v3/contents/generations/tasks/{task_id}` (`GET`)\n* **タスクのキャンセル/削除**: `/api/v3/contents/generations/tasks/{task_id}` (`DELETE`)\n* **タスク履歴の一覧表示**: `/api/v3/contents/generations/tasks` (`GET`)\n\n推奨 `doubao-seedance-2-5`（旧版 `doubao-seedance-2-0` は文末）。`content.role` で first_frame / last_frame / reference_* を指定。[動画生成 API](https://www.volcengine.com/docs/82379/1520757)。Seedance 2.5 は duration `4`–`30` または `-1`、編集は `ratio=adaptive` かつ `duration=-1`。\n\n### 4. 音声合成 API (TTS)\n* **イベントストリームモード (SSE)**: `/api/v3/tts/unidirectional/sse` (`POST`)\n* **非ストリーミング HTTP モード**: `/api/v3/tts/unidirectional` (`POST`)\n\nリクエストヘッダーは Volcengine ネイティブの `X-Api-Key: sk-your_token` 形式を使用する必要があり、モデルは `X-Api-Resource-Id` ヘッダーで指定するか、または `model` リクエストボディに記述できます。ゲートウェイは Volcengine 標準 of JSON データ（Base64 エンコードされたオーディオフレームを含む）を返却します。\n","title":"Ark ネイティブ API"},"ko":{"content":"# 볼케인엔진 화산방주 (Volcengine Ark) 네이티브 API 설명\n\n기존 비즈니스 시스템이 이미 볼케인엔진 화산방주 플랫폼(Volcengine Ark)에 연동되어 있는 경우, 코드를 OpenAI 형식으로 리팩토링할 필요가 없습니다. 게이트웨이는 볼케인엔진 네이티브 경로와 완전히 일치하는 포워딩 라우트를 제공합니다. 요청 헤더의 API Key를 본 플랫폼에서 할당한 통합 API 키로 바꾸기만 하면 됩니다.\n\n### 1. 네이티브 채팅 및 대화 (Chat & Responses)\n* **대화 엔드포인트**: `/api/v3/chat/completions`\n* **네이티브 응답 엔드포인트**: `/api/v3/responses`\n* **요청 메서드**: `POST`\n\n화산방주 네이티브 Request Payload의 완전한 투과 전송(Pass-through)을 지원합니다. 파라미터 규격에 대한 자세한 내용은 [화산방주 공식 문서](https://www.volcengine.com/docs/82379/1298454)를 참고하십시오.\n\n### 2. 네이티브 이미지 생성 API (Image Generations)\n* **엔드포인트**: `/api/v3/images/generations`\n* **요청 메서드**: `POST`\n\n화산방주 텍스트 기반 이미지 생성 API와 완벽하게 동기화되어 이미지 종횡비 지정, 프롬프트 스마트 재작성, 워터마크 등 네이티브 파라미터를 지원합니다.\n\n### 3. 네이티브 비디오 생성 작업 (Video Studio)\n* **작업 제출**: `/api/v3/contents/generations/tasks` (`POST`)\n* **작업 상태 조회**: `/api/v3/contents/generations/tasks/{task_id}` (`GET`)\n* **작업 취소/삭제**: `/api/v3/contents/generations/tasks/{task_id}` (`DELETE`)\n* **작업 이력 조회**: `/api/v3/contents/generations/tasks` (`GET`)\n\n권장 `doubao-seedance-2-5` (구버전 `doubao-seedance-2-0`은 해당 문서 하단). `content.role`로 first_frame / last_frame / reference_* 지정. [영상 생성 API](https://www.volcengine.com/docs/82379/1520757). Seedance 2.5 duration은 `4`–`30` 또는 `-1`, 편집은 `ratio=adaptive` 및 `duration=-1`.\n\n### 4. 음성 합성 API (TTS)\n* **이벤트 스트림 모드 (SSE)**: `/api/v3/tts/unidirectional/sse` (`POST`)\n* **비스트리밍 HTTP 모드**: `/api/v3/tts/unidirectional` (`POST`)\n\n요청 헤더는 볼케인엔진 네이티브 형식인 `X-Api-Key: sk-your_token`을 사용해야 하며, 모델은 `X-Api-Resource-Id` 헤더로 지정하거나 `model` 요청 본문에 작성할 수 있습니다. 게이트웨이는 볼케인엔진 표준 JSON 데이터(Base64로 인코딩된 오디오 프레임 포함)를 반환합니다.\n","title":"Ark 네이티브 API"},"vi":{"content":"# Hướng dẫn API Gốc Volcengine Ark\n\nNếu hệ thống nghiệp vụ hiện tại của bạn đã kết nối với nền tảng Volcengine Ark của Volcengine, bạn không cần phải tái cấu trúc mã nguồn sang định dạng OpenAI, vì Gateway cũng mở các tuyến chuyển tiếp tương thích hoàn toàn với đường dẫn gốc của Volcengine. Bạn chỉ cần thay thế API Key trong header yêu cầu bằng mã khóa API thống nhất được phân phối bởi nền tảng của chúng tôi.\n\n### 1. Trò chuyện và phản hồi gốc (Chat & Responses)\n* **Điểm cuối hội thoại (Chat endpoint)**: `/api/v3/chat/completions`\n* **Điểm cuối phản hồi gốc (Response endpoint)**: `/api/v3/responses`\n* **Phương thức yêu cầu**: `POST`\n\nHỗ trợ truyền tiếp đầy đủ Request Payload gốc của Volcengine Ark. Về đặc tả tham số, vui lòng tham khảo [Tài liệu chính thức của Volcengine Ark](https://www.volcengine.com/docs/82379/1298454).\n\n### 2. Giao diện tạo hình ảnh gốc (Image Generations)\n* **Điểm cuối (Endpoint)**: `/api/v3/images/generations`\n* **Phương thức yêu cầu**: `POST`\n\nCăn chỉnh hoàn hảo với giao diện chuyển văn bản thành hình ảnh của Ark, hỗ trợ các tham số gốc như chỉ định tỷ lệ khung hình hình ảnh, viết lại từ gợi ý thông minh, đóng dấu bản quyền (watermark), v.v.\n\n### 3. Tác vụ tạo video gốc (Video Studio)\n* **Gửi tác vụ**: `/api/v3/contents/generations/tasks` (`POST`)\n* **Truy vấn trạng thái tác vụ**: `/api/v3/contents/generations/tasks/{task_id}` (`GET`)\n* **Hủy/Xóa tác vụ**: `/api/v3/contents/generations/tasks/{task_id}` (`DELETE`)\n* **Danh sách lịch sử tác vụ**: `/api/v3/contents/generations/tasks` (`GET`)\n\nƯu tiên `doubao-seedance-2-5` (bản cũ `doubao-seedance-2-0` ở cuối trang Seedance). Dùng `content.role` (`first_frame` / `last_frame` / `reference_*`). Xem [API video](https://www.volcengine.com/docs/82379/1520757). Seedance 2.5: duration `4`–`30` hoặc `-1`; chỉnh sửa cần `ratio=adaptive` và `duration=-1`.\n\n### 4. Giao diện tổng hợp giọng nói (TTS)\n* **Chế độ luồng sự kiện (SSE)**: `/api/v3/tts/unidirectional/sse` (`POST`)\n* **Chế độ HTTP non-streaming**: `/api/v3/tts/unidirectional` (`POST`)\n\nHeader yêu cầu cần sử dụng định dạng gốc của Volcengine là `X-Api-Key: sk-your_token`, mô hình có thể được chỉ định bằng header `X-Api-Resource-Id` hoặc ghi trong phần thân yêu cầu (request body) `model`. Gateway sẽ trả về dữ liệu JSON tiêu chuẩn của Volcengine (chứa khung âm thanh mã hóa Base64).\n","title":"API gốc Ark"}},"updated_at":"2026-10-31T15:20:23.284Z"}}