Khóa API GPT Image 2: cách lấy quyền truy cập và gửi yêu cầu đầu tiên

Có, GPT Image 2 có API, và trên SeedRouter chỉ cần một khóa API (API key) là bạn truy cập được. Hãy đăng nhập, tạo khóa trên trang khóa API, nạp tín dụng trên trang thanh toán, rồi gửi khóa trong header Authorization: Bearer tới https://api.seedrouter.ai/v1/images/generations. Khóa chỉ hiển thị đầy đủ một lần duy nhất, lúc bạn tạo nó, nên hãy sao chép thẳng vào biến môi trường trên máy chủ của bạn.

Các bước dưới đây đưa bạn từ lúc chưa có tài khoản tới khi có một tấm ảnh hoàn chỉnh, và nói rõ bốn lỗi chặn phần lớn các yêu cầu đầu tiên.

Làm sao để lấy GPT Image 2 API key?

1. Đăng nhập SeedRouter bằng tài khoản Google của bạn.
2. Mở trang khóa API và tạo một khóa. Đặt cho nó một cái tên cho biết nơi khóa sẽ chạy, chẳng hạn production-server.
3. Sao chép khóa ngay lập tức. Sau màn hình này bạn chỉ còn thấy phiên bản đã che, và khóa bị mất thì không khôi phục được. Khi đó hãy thu hồi nó và tạo khóa mới.
4. Nạp tín dụng trên trang thanh toán. Khóa dùng được ngay khi vừa tạo, nhưng một yêu cầu cần có tín dụng mới chạy được.

Một khóa dùng được cho mọi mô hình trên SeedRouter, nên bạn không cần khóa riêng cho GPT Image 2 và GPT Image 2.5. Thay vào đó, hãy tạo khóa riêng cho từng môi trường. Khi ấy thu hồi khóa staging sẽ không thể làm hỏng production.

Nên lưu khóa API ở đâu?

Trên máy chủ của bạn, trong một biến môi trường, và không ở đâu khác:

export SEEDROUTER_API_KEY="your-key"

Đừng bao giờ đặt khóa trong JavaScript chạy trên trình duyệt, trong gói ứng dụng di động hay trong một kho mã công khai. Bất kỳ ai đọc được khóa đều có thể tiêu tín dụng của bạn. Nếu sản phẩm của bạn có front end, hãy để nó gọi back end của chính bạn, rồi để back end gọi API bằng khóa.

Nếu khóa bị lộ, hãy thu hồi nó ngay trên trang khóa API. Khóa đã thu hồi sẽ ngừng hoạt động, và các yêu cầu dùng nó đều bị từ chối.

Gửi yêu cầu đầu tiên bằng khóa API thế nào?

Gửi khóa dưới dạng bearer token. Phản hồi là một tham chiếu tác vụ, không phải ảnh:

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "An amber glass bottle on a cream background, studio lighting",
    "size": "1024x1024",
    "quality": "low"
  }'

Lưu id trong phản hồi và truy vấn GET https://api.seedrouter.ai/v1/tasks/{id} với cùng header cho tới khi status là completed. Tác vụ hoàn tất liệt kê các URL ảnh. Để có một vòng lặp hoàn chỉnh bằng code, xem GPT Image 2 API với Python.

Hai ID mô hình phục vụ GPT Image 2 với cùng các trường: gpt-image-2 tính một mức giá cố định cho mỗi ảnh được giao, còn gpt-image-2-official tính theo số token mà mỗi lần dựng ảnh báo về. Khóa dùng được với cả hai. Giá hiện tại có trên trang mô hình.

Khóa API mới thường gặp những lỗi nào?

Hai sơ suất gây ra phần lớn lỗi ở yêu cầu đầu tiên. Một là dán khóa bị thiếu ký tự hoặc thừa dấu cách, trả về 10001. Hai là chép tên mô hình từ tiêu đề, như gpt-image-2.0 hay GPT Image 2, thay vì ID mô hình, trả về 20002. Cả hai đều bị từ chối trước khi bất kỳ xử lý nào bắt đầu, nên không bị tính phí.

Có GPT Image 2 API key miễn phí không?

Không. Tạo khóa thì miễn phí, nhưng các yêu cầu được trả bằng tín dụng nạp trước. Điều bạn không phải trả là thất bại: một tác vụ kết thúc ở failed, hoặc không trả về ảnh nào, không tốn gì. Tín dụng được mua bằng các lần nạp một lần, không bao giờ hết hạn và không kèm gói đăng ký, nên một lần nạp nhỏ đầu tiên là đủ để kiểm thử tích hợp một cách đầy đủ.

Một khóa có dùng được từ Python và JavaScript không?

Có. Khóa là một chuỗi trong HTTP header, nên bất kỳ ngôn ngữ nào gửi được yêu cầu HTTP đều dùng được. Hãy đọc khóa từ biến môi trường trong từng môi trường chạy: os.environ["SEEDROUTER_API_KEY"] trong Python và process.env.SEEDROUTER_API_KEY trong Node.js. Giữ phần JavaScript ở phía máy chủ; cùng khóa đó đặt trong code trình duyệt sẽ lộ ra với mọi khách truy cập.

Câu hỏi thường gặp

Có cần OpenAI API key để dùng GPT Image 2 ở đây không?

Không. Khóa SeedRouter là thông tin xác thực duy nhất bạn gửi. Bạn không phải tạo hay quản lý một tài khoản riêng ở nơi khác để gọi GPT Image 2 qua API này.

Có thể tạo bao nhiêu khóa API?

Đủ để mỗi máy chủ hay dịch vụ có một khóa; giới hạn mỗi tài khoản cao hơn nhiều so với nhu cầu của một tích hợp. Mỗi khóa có thể được thu hồi riêng.

Xem một khóa đã tiêu bao nhiêu ở đâu?

Trong lịch sử sử dụng. Mỗi yêu cầu ghi mô hình và khoản trừ của nó, nên dễ dàng đối chiếu một tích hợp mới với con số bạn ước tính.

Giữ khóa trên máy chủ và triển khai

Tạo một khóa cho mỗi môi trường, lưu nó trong biến môi trường và chỉ gửi nó dưới dạng bearer token từ back end của bạn. Khi yêu cầu đầu tiên trả về id của tác vụ, phần truy cập đã xong; mọi thứ sau đó nằm trong tài liệu tham chiếu GPT Image 2 API.