[{"data":1,"prerenderedAt":125},["ShallowReactive",2],{"reference-detail-zh-get_ai_video_cost_api_v1_ai_video_cost_get":3,"developer-code-un8ihy":123,"developer-code-ijy0uv":124},{"tag":4,"sourceTag":5,"tagSlug":6,"method":7,"path":8,"slug":9,"summary":10,"description":11,"operationId":12,"groupOrder":13,"descriptionHtml":14,"parameters":15,"responses":43,"security":110,"codeSamples":113},"AI Video","AI Videos","ai-videos","GET","\u002Fapi\u002Fv1\u002Fai_video\u002Fcost","get-ai-video-cost","估算点数成本","提交生成请求前，使用与实际扣费相同的公式估算所需点数。省略 `resolution` 时，按模型默认分辨率估价。\n\nBeta：所有有效付费订阅账户均可使用，适用标准的单 API Key 请求频率限制。","get_ai_video_cost_api_v1_ai_video_cost_get",60,"\u003Cp>提交生成请求前，使用与实际扣费相同的公式估算所需点数。省略 \u003Ccode>resolution\u003C\u002Fcode> 时，按模型默认分辨率估价。\u003C\u002Fp>\u003Cp>Beta：所有有效付费订阅账户均可使用，适用标准的单 API Key 请求频率限制。\u003C\u002Fp>",[16,23,28,33,39],{"name":17,"in":18,"required":19,"description":20,"type":21,"example":22},"X-API-Key","header",true,"你的 VisionStory API Key（`sk-vs-...`），请仅保存在服务端。可在 [API Key 管理](\u002Fapi-keys) 中创建或管理，需要 Pro 或更高方案。","string","sk-vs-your-api-key",{"name":24,"in":25,"required":19,"description":26,"type":21,"example":27},"model_id","query","用于估价的模型。请使用 GET \u002Fapi\u002Fv1\u002Fai_video\u002Fmodels 返回的 ID，例如 `seedance-2.0`。","seedance-2.0",{"name":29,"in":25,"required":19,"description":30,"type":31,"example":32},"duration_sec","用于估价的视频时长，单位为秒。必须是该模型允许的值，请查询 GET \u002Fapi\u002Fv1\u002Fai_video\u002Fmodels。","integer",8,{"name":34,"in":25,"required":35,"description":36,"type":37,"example":38},"resolution",false,"用于估价的输出分辨率，例如 `480p` \u002F `720p` \u002F `1080p` \u002F `4k`。可选值因模型而异；省略时使用模型默认值。","string | null","720p",{"name":40,"in":25,"required":35,"description":41,"type":42,"example":19},"generate_audio","是否请求生成原生音轨。此参数与创建请求保持一致；音轨不影响价格。","boolean | null",[44,81],{"status":45,"description":46,"contentType":47,"schema":48,"example":71,"examples":75,"headers":80},"200","请求成功","application\u002Fjson",{"type":49,"description":50,"nullable":35,"properties":51},"BaseSuccessResponse_AiVideoCostResponse_","",[52,61,66],{"name":53,"required":19,"type":54,"description":55,"nullable":19,"properties":56},"data","AiVideoCostResponse | null","当前接口的响应数据，字段定义见该接口的响应结构。仅当操作不返回数据时为 null。",[57],{"name":58,"required":19,"type":31,"description":59,"nullable":35,"properties":60},"credit","按给定参数估算的生成点数，使用与实际扣费相同的公式。",[],{"name":62,"required":35,"type":21,"description":63,"nullable":35,"default":64,"properties":65},"message","便于阅读的状态消息；调用成功时为 `\"success\"`。","success",[],{"name":67,"required":19,"type":68,"description":69,"nullable":35,"properties":70},"server_time","string · date-time","服务端生成响应时的时间戳，使用 ISO 8601 格式（UTC）。",[],{"data":72,"message":64,"server_time":74},{"credit":73},16,"2026-09-04T00:00:00Z",[76],{"name":64,"description":77,"summary":46,"value":78},"示例仅用于说明响应结构，不代表实时账户数据或实际报价。ID 和 URL 均为占位内容。请调用模型查询及费用估算接口，获取当前可用模型和价格。",{"data":79,"message":64,"server_time":74},{"credit":73},[],{"status":82,"description":83,"contentType":47,"schema":84,"example":106,"headers":109},"default","错误响应。所有失败均使用统一结构：`error` 对象包含数字错误码 `code`、便于阅读的 `message`、可选的 `details` 字符串，以及提供后续处理建议的可选 `hint`（便于 AI Agent 使用）。",{"type":85,"description":50,"nullable":35,"properties":86},"ErrorResponse",[87],{"name":88,"required":19,"type":89,"description":50,"nullable":35,"properties":90},"error","ErrorDetail",[91,95,99,103],{"name":92,"required":19,"type":31,"description":93,"nullable":35,"properties":94},"code","机器可读的错误码。传输层失败时对应 HTTP 状态码（例如 401、404、422、500），其他情况可能使用业务专用错误码。",[],{"name":96,"required":35,"type":37,"description":97,"nullable":19,"properties":98},"details","可选的结构化错误详情，例如 422 响应中逐字段校验错误的 JSON 字符串。无补充信息时不返回。",[],{"name":100,"required":35,"type":37,"description":101,"nullable":19,"properties":102},"hint","供用户和 AI Agent 参考的错误处理建议，例如如何修正请求或在哪里获取 API Key。可能不返回此字段。",[],{"name":62,"required":19,"type":21,"description":104,"nullable":35,"properties":105},"便于阅读的错误原因说明，可安全记录到日志或展示给最终用户；此返回值未本地化。",[],{"error":107},{"code":108,"message":21,"details":21,"hint":21},1,[],[111],{"APIKeyHeader":112},[],[114,117,120],{"lang":115,"source":116},"SDK","from visionstory import VisionStoryClient\n\nclient = VisionStoryClient.from_env()\ncost = client.ai_video_cost(\n    model_id=\"seedance-2.0\",\n    duration_sec=8,\n    resolution=\"720p\",\n    generate_audio=True,\n)\nprint(cost)",{"lang":118,"source":119},"REST","import os\nimport requests\n\nresponse = requests.get(\n    \"https:\u002F\u002Fopenapi.visionstory.ai\u002Fapi\u002Fv1\u002Fai_video\u002Fcost\",\n    headers={\"X-API-Key\": os.environ[\"VISIONSTORY_API_KEY\"]},\n    params={\n      \"model_id\": \"seedance-2.0\",\n      \"duration_sec\": 8\n    },\n)\nresponse.raise_for_status()\nprint(response.json())",{"lang":121,"source":122},"cURL","curl --request GET 'https:\u002F\u002Fopenapi.visionstory.ai\u002Fapi\u002Fv1\u002Fai_video\u002Fcost?model_id=seedance-2.0&duration_sec=8' \\\n  --header 'X-API-Key: $VISIONSTORY_API_KEY'","\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#FF7B72\">from\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> visionstory \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">import\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> VisionStoryClient\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">client \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> VisionStoryClient.from_env()\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">cost \u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\"> client.ai_video_cost(\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFA657\">    model_id\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"seedance-2.0\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFA657\">    duration_sec\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\">8\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFA657\">    resolution\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"720p\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFA657\">    generate_audio\u003C\u002Fspan>\u003Cspan style=\"color:#FF7B72\">=\u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\">True\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">)\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#79C0FF\">print\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">(cost)\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>","\u003Cpre class=\"shiki github-dark-default\" style=\"background-color:#0d1117;color:#e6edf3\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">{\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">  \"data\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">    \"credit\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#79C0FF\">16\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">  },\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">  \"message\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"success\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#7EE787\">  \"server_time\"\u003C\u002Fspan>\u003Cspan style=\"color:#E6EDF3\">: \u003C\u002Fspan>\u003Cspan style=\"color:#A5D6FF\">\"2026-09-04T00:00:00Z\"\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E6EDF3\">}\u003C\u002Fspan>\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>",1788547144514]