2026-04-28 12:12:58 +08:00
|
|
|
{
|
|
|
|
|
"name": "VolcEngine",
|
|
|
|
|
"url": {
|
|
|
|
|
"default": "https://ark.cn-beijing.volces.com/api/v3"
|
|
|
|
|
},
|
|
|
|
|
"url_suffix": {
|
|
|
|
|
"chat": "chat/completions",
|
2026-05-08 15:54:27 +08:00
|
|
|
"files": "files",
|
Go: implement ListModels in Volcengine driver (#14702)
### What problem does this PR solve?
The VolcEngine Go driver in `internal/entity/models/volcengine.go`
shipped with a
`ListModels` stub that returned `volcengine, no such method`.
`conf/models/volcengine.json`
also did not declare a `models` URL suffix, so the model picker had
nothing to call even
if the method body were filled in.
A tenant who configured Volcengine (Doubao / Ark) as a provider could
not see the list of
available endpoints from the RAGFlow UI. Several other Go drivers
already implement
`ListModels` against the OpenAI-compatible `/models` endpoint (deepseek,
gitee, nvidia,
openai, siliconflow), so the interface and pattern are well-established.
This PR fills the gap.
### What this PR includes
* `conf/models/volcengine.json`: declare the `models` URL suffix
alongside the existing
`chat`, `files`, and `embedding` entries. The Ark v3 API exposes
`https://ark.cn-beijing.volces.com/api/v3/models`, so the suffix is just
`models`.
* `internal/entity/models/volcengine.go`: replace the `ListModels` stub
with a real
implementation. Reuses the package-level `DSModelList` / `DSModel` types
that
DeepSeek, Gitee, and SiliconFlow already use to parse the
OpenAI-compatible models
response shape.
No factory change. No interface change.
### How the driver works
* Resolves the region with a default fallback, the same way the other
VolcEngine methods
in this driver already do.
* Builds the URL from `BaseURL[region] + URLSuffix.Models`, with
`strings.TrimSuffix` on
the base to keep the join robust.
* Issues a `GET` with optional `Authorization: Bearer <api_key>` (the
header is omitted
when no key is configured, mirroring the existing NVIDIA `ListModels`).
* Reads the response body once, surfaces a non-200 with the upstream
status line plus
body, and parses the JSON via the shared `DSModelList` type.
* Returns the model id list in input order. When the response includes
an `owned_by`
field, the entry is rendered as `id@owned_by`, matching the convention
used by the
other Go drivers.
### Type of change
- [x] New Feature (non-breaking change which adds functionality)
### How was this tested?
* `go build ./internal/entity/models/...` returns exit 0.
* `go vet ./internal/entity/models/...` is clean.
* `gofmt -l internal/entity/models/volcengine.go` is clean.
* The full method set on `VolcEngine` still matches the `ModelDriver`
interface.
* Endpoint reachability check: `GET
https://ark.cn-beijing.volces.com/api/v3/models`
returns `401 Unauthorized` without an API key, confirming the path
exists and accepts
Bearer authentication.
* Pattern parity with DeepSeek, Gitee, NVIDIA, and SiliconFlow
`ListModels`.
Fixes #14701
Co-authored-by: Jin Hai <haijin.chn@gmail.com>
2026-05-10 16:59:18 -10:00
|
|
|
"embedding": "embeddings/multimodal",
|
|
|
|
|
"models": "models"
|
2026-04-28 12:12:58 +08:00
|
|
|
},
|
2026-04-28 16:05:15 +08:00
|
|
|
"class": "volcengine",
|
2026-04-28 12:12:58 +08:00
|
|
|
"models": [
|
|
|
|
|
{
|
|
|
|
|
"name": "doubao-seed-2-0-pro-260215",
|
|
|
|
|
"max_tokens": 262144,
|
|
|
|
|
"model_types": [
|
|
|
|
|
"chat"
|
2026-04-29 15:45:08 +08:00
|
|
|
],
|
|
|
|
|
"thinking": {
|
|
|
|
|
"default_value": true,
|
|
|
|
|
"clear_thinking": true
|
|
|
|
|
}
|
2026-05-08 15:54:27 +08:00
|
|
|
},
|
|
|
|
|
{
|
|
|
|
|
"name": "doubao-embedding-vision-250615",
|
|
|
|
|
"max_tokens": 131072,
|
|
|
|
|
"model_types": [
|
|
|
|
|
"embedding"
|
|
|
|
|
]
|
2026-04-28 12:12:58 +08:00
|
|
|
}
|
|
|
|
|
]
|
|
|
|
|
}
|