API 客户端
两个小客户端,各一个文件,没有依赖。它们先询价、限定扣费上限,重试时保持同一个请求密钥。
Python
Python 3.10 或更高版本,只用标准库。把文件保存在你的程序旁边: pickshot.py
from pickshot import Pickshot
client = Pickshot(os.environ["PICKSHOT_API_KEY"])
request = {"model": "indigo", "prompt": "a red paper boat on a calm lake"}
quote = client.estimate("images", request)
result = client.create("images", request, max_credits=quote["credits"], idempotency_key="my-boat-001")JavaScript
Node.js 22 或更高版本。把文件保存在你的程序旁边。声明文件为 TypeScript 提供类型: pickshot.mjs · pickshot.d.mts
import { Pickshot } from "./pickshot.mjs";
const client = new Pickshot({ apiKey: process.env.PICKSHOT_API_KEY });
const request = { model: "indigo", prompt: "a red paper boat on a calm lake" };
const quote = await client.estimate("images", request);
const result = await client.create("images", request, { maxCredits: quote.credits, idempotencyKey: "my-boat-001" });两者都能做的事
- 读取模型和价格(models)。
- 询问准确请求的价格(estimate),绝不扣费。
- 在你给定的最高金额内生成(create),重试时请求密钥不变。
- 跟踪任务直到结束(wait),不会启动新任务。
在 API 页面创建密钥,并放在服务器的环境变量里。用密钥生成的所有内容都消耗积分。 创建 API 密钥
其他使用方式
- REST API 由一个 OpenAPI 文件描述。 OpenAPI 描述
- 用 MCP 连接 AI 助手。 MCP
- 在浏览器里先看价格再试用模型。 试验场
常见问题
它们在包注册中心里吗?
不在。它们是在这里下载的单个文件,不需要安装。
要花钱吗?
客户端免费。它们发起的每次生成按 API 价格消耗积分。