SDK 会使用 bearer API key 对每个请求进行认证。你只需构建一次 YoukaClient，并在进程的整个生命周期内复用它。
new YoukaClient(options)
import { YoukaClient } from "@youka/zh/sdk";
const client = new YoukaClient({
apiKey: process.env.YOUKA_API_KEY!,
});
Options
自定义 fetch 实现。默认使用全局 fetch。可用于注入日志、代理或自定义重试中间件。
存储 API key
API key 可访问你的计费信息。不要将其提交到源码仓库。
Environment variable
Secret manager
const client = new YoukaClient({
apiKey: process.env.YOUKA_API_KEY!,
});
import { getSecret } from "./my-secret-manager";
const client = new YoukaClient({
apiKey: await getSecret("youka-api-key"),
});
注入自定义 fetch
每个 SDK 方法都会使用你传给构造函数的 fetch。这让你很容易添加日志或中间件：
import { YoukaClient } from "@youka/zh/sdk";
const instrumentedFetch: typeof fetch = async (input, init) => {
const start = Date.now();
const response = await fetch(input, init);
console.log(
`${init?.method ?? "GET"} ${input} ${response.status} in ${Date.now() - start}ms`,
);
return response;
};
const client = new YoukaClient({
apiKey: process.env.YOUKA_API_KEY!,
fetch: instrumentedFetch,
});
每个请求的选项
每个方法都接受一个可选的第二或第三个参数，用于传入请求级别的选项：
await client.projects.create(body, {
idempotencyKey: "import-2026-04-08-song-001",
signal: abortController.signal,
});
以 Idempotency-Key 请求头传递。对相同 payload 复用同一个 key 时，将返回原始结果而不是创建重复资源。参见 API
idempotency。 标准的 abort signal。可取消进行中的请求以及长时间运行的
client.tasks.wait(...), client.projects.wait(...), 和
client.exports.wait(...) 轮询。
接下来
