跳到正文
登录免费开始

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 价格消耗积分。