byted-ark-seedance-guide

seedance-guide Volcano Ark Seedance usage guide skill

Function Description

Volcano Ark Seedance model usage guide skill, supportingsearching official documentation by ServiceCodes=arkandretrieving the full text of documentation based on Volcano Engine official website documentation links. Applicable to Seedance-related questions about Ark access, API calls, parameter explanations, task creation, task querying, generation result retrieval, billing activation, error troubleshooting, SDK, and best practices; also applicable to scenarios where the user directly provides a https://www.volcengine.com/docs/... official documentation link and requests a summary, interpretation, extraction of rules, locating parameters, or answers based on that documentation.

Decision Logic (Must Read)

Trigger Judgment Rules

1. Seedance-related usage questions: When users mention Seedance, seedance2.0, Seedance 2.0, doubao-seedance-2-0, doubao-seedance-2-0-fast, doubao-seedance-2-0-mini, video generation, text-to-video, image-to-video, first and last frames, multimodal reference video generation, creating video tasks, querying video tasks, or other Volcano Ark usage questions, prioritize invoking this skill.
2. User provides a Volcano Engine official website documentation link: When the user message contains volcengine.com/docs/ or www.volcengine.com/docs/ in the form of an official documentation link, for example https://www.volcengine.com/docs/82379/2222480、https://www.volcengine.com/docs/82379/1520757?lang=zh, and requests operations such as "summarize/interpret/extract/query/answer based on the documentation/look at this documentation", directly call the fetch interface to obtain the complete content, without needing to search first.
3. Non-Seedance or non-Ark questions: Unless the user explicitly requests to look up Ark Seedance documentation, do not use this skill as a general Volcano Engine documentation search tool.

Rules for coordinating search and fetch

1. User question-type requests: Prioritize calling the search interface, and it must carry the product code ark, i.e., ServiceCodes: ["ark"]; return 5 results, and prioritize using the returned Content to answer.
2. Keyword completion: If the user only asks a generic question such as "how to use seedance", the search terms should be supplemented with key information such as "Volcano Ark Seedance 2.0 doubao-seedance-2-0 create video generation task query video generation task API".
3. Secondary search optimization: If the first search results are not highly relevant, still keep ServiceCodes: ["ark"], rewrite the keywords, and search again.
4. Full-product fallback search: If the second search results are still not highly relevant after rewriting the keywords while keeping ServiceCodes: ["ark"] , then the third search should not carry the ServiceCodes parameter, perform a full-product search, and then select the most relevant official documentation from the results; do not switch to LAS or other product documentation unless the full-product fallback search hits and the content is indeed relevant, or the user explicitly requests a comparison.
5. Need complete documentation content: First call search to find the corresponding documentation link, then call fetch to obtain the full text content.
6. User has already provided the official documentation URL: Do not take a detour through search again; first clean the URL query parameters, directly call fetch to obtain the full text, and then answer around the content of that documentation.

Function Description

1. Document Retrieval (search)

Retrieve official documents related to Volcano Ark Seedance based on user questions, always filtered by product code ark .

• Request URL:https://docs-api.cn-beijing.volces.com/api/v1/doc/search

Request Parameters

Parameter Name	Type	Required	Description
Query	string	Yes	The user's specific question description
Limit	number	No	Number of documents returned by retrieval, defaults to returning 5 documents
ServiceCodes	array	No	Product filter condition, specifies to query only documents of certain products; the product code can be obtained through the ServiceCodes field in the returned results

Response Parameters

The core valid data is in the Result.DocList field, and each document item contains:

Field Name	Type	Description
Title	string	Official document title
Url	string	Official document access link
Content	string	Complete document content
ServiceCodes	array	List of product codes to which the document belongs

---

2. Content Retrieval (fetch)

Based on the official Volcano Engine document link, retrieve the corresponding complete document content, supporting structured parsing of the document title and body content.

• Request URL:https://docs-api.cn-beijing.volces.com/api/v1/doc/fetch

Request Parameters

Parameter Name	Type	Required	Description
Url	string	Yes	Official Volcano Engine document link, in the format such as https://www.volcengine.com/docs/6349/162514

⚠️ Important Processing Rules: If the Url contains query parameters (for example https://www.volcengine.com/docs/6396/624853?lang=zh), all query parameters need to be removed before the request, keeping only the https://www.volcengine.com/docs/6396/624853 part for the request.

Response Parameters

The core valid data is in the Result field:

Field Name	Type	Description
Title	string	The complete title of the document
Content	string	The complete body content of the document, as structured parsed text

Result Processing Rules

General Mandatory Rules

1. At the end of all answersmustattach the corresponding official document link as the reference source, using the [文档标题](纯净URL) format, and each result must be marked with its source address
2. If multiple results are returned, display them sorted by relevance, showing at most the 3 most relevant results, with each result accompanied by the corresponding document link
3. Links must use those returned by the scriptCleanUrl(with all query parameters stripped), and it is forbidden to use URLs with?lang=zhand other parameters

Retrieval Result Processing

1. Prioritize using the returned Content to answer the user's question, as the information is more accurate
2. The API directly returns the complete document content, with no need for additional summarization or extraction

Content Retrieval Result Processing

1. The API directly returns the complete document content, which can be used directly without additional processing

Tool Usage Method

Retrieve Documents

python {skill_dir}/scripts/seedance-docs.py search "查询关键词" 5 ark

Example:

python {skill_dir}/scripts/seedance-docs.py search "火山方舟 Seedance 2.0 创建视频生成任务 API" 5 ark

Recommended retrieval keywords:

python {skill_dir}/scripts/seedance-docs.py search "火山方舟 doubao-seedance-2-0 文生视频 图生视频 创建任务 查询任务 API" 5 ark
python {skill_dir}/scripts/seedance-docs.py search "Seedance 2.0 fast doubao-seedance-2-0-fast 参数 计费 开通 报错" 5 ark
python {skill_dir}/scripts/seedance-docs.py search "方舟 Seedance 多模态参考生视频 首帧 首尾帧 视频生成教程" 5 ark

Retrieve Complete Document Content

python {skill_dir}/scripts/seedance-docs.py fetch "火山引擎文档链接"

Example:

python {skill_dir}/scripts/seedance-docs.py fetch "https://www.volcengine.com/docs/82379/1520757?lang=zh"