Nodes/Duanyll Nodepack/Create Ark Client
ComfyUI Node

Create Ark Client

Volcengine's Gemini killer, wired into ComfyUI

By Duanyll·Created about a year ago·Updated 4 months ago· 2
Create Ark Client
    • ARK_CLIENT
    base_urlhttps://ark.cn-beijing.volces.com/api/v3
    api_key

    Create Ark Client is the pack's hook into Volcano Engine's Ark (火山方舟) platform - ByteDance's hosted API for running frontier models like Doubao (豆包) without owning the hardware. It builds an ARK_CLIENT object that the pack's SeedEdit Node consumes, and it's the clearest sign that this pack was written by someone in China: the code comments are in Chinese, the default endpoint is Beijing, and the whole thing assumes you know what Ark is.

    If you don't live in that ecosystem, here's the context. Ark is ByteDance's answer to OpenAI's API - a paid, OpenAI-compatible endpoint serving their Doubao LLM family (and, via a proxy, things like Gemini and DeepSeek) with strong vision capabilities and aggressive pricing. The SeedEditNode that consumes this client uses the LLM to regenerate or edit images in a seed-edit loop. For a Chinese ComfyUI user with a Doubao API key, this is the same role LLM Create Client plays for OpenAI-compatible endpoints, but purpose-built for Ark.

    The inputs

    Only two, and both optional:

    • base_url - defaults to https://ark.cn-beijing.volces.com/api/v3, Ark's Beijing regional endpoint. Change it if you're on a different region or a compatible mirror.
    • api_key - your Ark key. Leave it empty and the node falls back to the ARK_API_KEY environment variable. If neither exists, it raises a clear error telling you exactly that.

    One output: ARK_CLIENT, feeding the pack's SeedEditNode.

    Install and the dependency trap

    The pack's requirements list includes volcengine-python-sdk[ark] - and this node genuinely needs it. It's the one node in the pack whose dependency is a vendored vendor SDK, and ComfyUI Manager installs the pack's full requirements on install, so you'll get it automatically.

    cd ComfyUI/custom_nodes
    git clone https://github.com/Duanyll/duanyll_nodepack
    cd duanyll_nodepack && pip install -r requirements.txt
    

    If it's missing, the node imports it lazily and raises a helpful "run pip install volcengine-python-sdk[ark]" error rather than a cryptic stack trace.

    The honest framing

    This node is only useful to you if (a) you have an Ark/Doubao API key and (b) you want the seed-edit workflow. If neither is true, it's dead weight - though it's harmless dead weight since you only pay for the SDK install, not the API calls. Nobody on Reddit is discussing this pack's Ark integration; it's a personal tool for a personal workflow, which is exactly the kind of thing that makes these small packs worth a look. The env-var fallback for the API key is a genuinely nice security touch you don't always see in custom nodes, and the whole node is a clean 40 lines. For the target audience - Chinese ComfyUI users already paying for Ark - it's the missing connector.

    Categoryduanyll/models/ark

    Inputs (2)

    NameTypeDefaultDescription
    base_urloptSTRINGhttps://ark.cn-beijing.volces.com/api/v3
    api_keyoptSTRING

    Outputs (1)

    NameTypeDescription
    ARK_CLIENTARK_CLIENT