VI ▾
Lấy khóa API

Khóa API Flux: Nó là gì và API văn bản nằm ở đâu

Khóa API Flux là thông tin xác thực cho dịch vụ tạo ảnh, và trang web này không bán loại khóa đó. Trang web này bán một khóa khác, dành cho API LLM văn bản được lưu trữ, có thể viết và mở rộng các prompt bạn đưa vào mô hình ảnh.

Cập nhật

Hai khóa riêng biệt, một liên kết với khung ảnh và một liên kết với bong bóng chat, hai API riêng biệt

Điểm chính

  • Khóa cho dịch vụ ảnh Flux và khóa cho API LLM văn bản là hai thứ riêng biệt, do hai nhà cung cấp riêng biệt cấp.
  • Trang web này chỉ dành cho văn bản: không tạo ảnh, âm thanh hoặc video, và nó không do bất kỳ nhà cung cấp mô hình ảnh nào vận hành.
  • Khóa văn bản hữu ích bên cạnh khóa ảnh vì viết prompt là tác vụ văn bản, tính phí theo token.
  • Bạn chỉ cần thay đổi một Base URL và một khóa API trong bất kỳ client OpenAI nào để bắt đầu, và tín dụng dùng thử sẽ chi trả cho các thử nghiệm đầu tiên.

Điều mọi người thường hiểu là khóa Flux

Flux là tên của một nhóm các mô hình chuyển đổi văn bản sang ảnh. Khi ai đó gõ flux api key vào ô tìm kiếm, họ hầu như luôn muốn một credential cho phép mã của họ gửi một prompt đến dịch vụ lưu trữ một trong những mô hình ảnh đó và nhận lại hình ảnh. Credential đó đến từ công ty vận hành endpoint ảnh mà bạn đã chọn. Nó được liên kết với tài khoản, thanh toán và điều khoản của họ.

Bạn sẽ thấy cụm từ này được sử dụng theo một vài cách hơi khác nhau, và việc phân loại chúng giúp ích trước khi bạn dán khóa vào bất cứ đâu:

  • Một khóa từ nhà cung cấp ảnh phục vụ các mô hình Flux, được sử dụng trong một yêu cầu trả về ảnh.
  • Một khóa cho thiết lập cục bộ hoặc tự lưu trữ, nơi bạn tự tạo token và dữ liệu không rời khỏi máy của bạn.
  • Một khóa cho một công cụ khác trong quy trình của bạn, chẳng hạn như mô hình văn bản viết prompt, chỉ được gọi là Flux vì dự án có tên như vậy.

Chỉ hai cái đầu tiên tạo ra ảnh. Cái thứ ba là nơi trang web này hoạt động. Chúng tôi vận hành một API LLM tương thích OpenAI được lưu trữ, và khóa bạn nhận được ở đây hoạt động với API đó và không có gì khác.

Tại sao khóa hình ảnh không thể gọi mô hình chat

Hai loại khóa nhìn có vẻ giống nhau vì cả hai đều là chuỗi dài bạn gửi trong tiêu đề Authorization, nhưng chúng mở những cánh cửa khác nhau. Khóa của nhà cung cấp ảnh được kiểm tra bởi chính nhà cung cấp ảnh đó. Nếu bạn gửi nó đến một endpoint chat, bạn sẽ nhận được lỗi xác thực, và điều ngược lại cũng đúng: một khóa từ trang web này sẽ trả về lỗi nếu bạn gửi nó đến một máy chủ ảnh.

Nội dung yêu cầu cũng khác nhau. Một lệnh gọi ảnh thường bao gồm một prompt, kích thước, seed và số lượng ảnh. Một lệnh gọi chat bao gồm một danh sách các tin nhắn với các vai trò, và trả về văn bản. Không có lược đồ chung, vì vậy không có gì để chuyển đổi giữa chúng. Nếu bạn có một script hoạt động với nhà cung cấp ảnh, hãy giữ nguyên script và khóa đó. Thêm lệnh gọi văn bản như một bước riêng biệt ở phía trước.

Dịch vụ này không làm gì

Để giữ kỳ vọng rõ ràng: API ở đây chỉ dành cho văn bản. Nó không tạo ảnh, âm thanh hoặc video, không tạo embedding và không cung cấp fine-tuning. Nó không phải là API chính thức của bất kỳ nhà cung cấp mô hình nào và không phải là router giữa các nhà cung cấp. Nó phục vụ một mô hình trọng số mở, được tinh chỉnh để trả lời mà không từ chối nội dung cho mục đích người lớn hợp pháp, và được vận hành bởi một nhà cung cấp độc lập. ID mô hình bạn truyền là uncensored.

API văn bản nằm ở đâu bên cạnh khóa hình ảnh

Viết prompt là điểm gặp gỡ rõ ràng nhất. Các mô hình ảnh phản hồi tốt với các mô tả cụ thể, có cấu trúc: chủ thể, bối cảnh, ống kính, ánh sáng, màu sắc, tâm trạng. Hầu hết mọi người viết những mô tả này bằng tay, sau đó viết lại sau một kết quả kém. Một mô hình văn bản có thể thực hiện bản nháp đầu tiên, mở rộng một ý tưởng ba từ thành một mô tả đầy đủ, hoặc tạo ra hai mươi biến thể về một chủ đề trong khi bạn đi lấy cà phê.

Một số công việc phù hợp:

  • Mở rộng. Chuyển một ý tưởng ngắn thành một prompt chi tiết theo phong cách bạn đã đặt một lần trong system message.
  • Biến thể. Yêu cầu mười cách tiếp cận khác nhau cho một chủ đề, được trả về dưới dạng danh sách JSON mà script của bạn có thể lặp qua.
  • Dọn dẹp. Viết lại một prompt lộn xộn do khách hàng viết thành thứ gì đó mà mô hình ảnh xử lý tốt hơn.
  • Kịch bản và chú thích. Viết lời bình, danh sách cảnh hoặc chú thích đi kèm hình ảnh.

Vì mô hình ở đây không từ chối theo mặc định, nó phù hợp với truyện, thiết kế nhân vật và các chủ đề trưởng thành mà các mô hình được lưu trữ khác thường từ chối, miễn là việc sử dụng là hợp pháp và liên quan đến người trưởng thành. Một giới hạn cứng áp dụng ở mọi nơi: không có nội dung tình dục liên quan đến người chưa thành niên. Các yêu cầu như vậy không phải là thứ chúng tôi hỗ trợ dưới bất kỳ hình thức nào.

Lần gọi đầu tiên trong dưới một phút

Bất kỳ SDK OpenAI hoặc client HTTP nào cũng hoạt động sau khi bạn thay đổi Base URL và khóa. Endpoint cho chat là POST /v1/chat/completions, và GET /v1/models liệt kê mô hình. Dưới đây là cùng một yêu cầu bằng curl và Python.

curl https://api.fluxapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You write detailed image prompts. Reply with the prompt only."},
      {"role": "user", "content": "a lighthouse in a storm, painterly"}
    ]
  }'
from openai import OpenAI

client = OpenAI(
    base_url="https://api.fluxapikey.com/v1",
    api_key="YOUR_KEY",
)

reply = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You write detailed image prompts. Reply with the prompt only."},
        {"role": "user", "content": "a lighthouse in a storm, painterly"},
    ],
)
print(reply.choices[0].message.content)

Chuỗi trả về là thứ bạn chuyển cho dịch vụ ảnh của bạn, sử dụng khóa riêng của dịch vụ đó. Hai dịch vụ này không bao giờ chạm vào nhau. Để xem danh sách đầy đủ các tham số, bao gồm streaming, gọi hàm và chế độ JSON, hãy xem tài liệu API.

Bạn có cần cả hai khóa không?

Nó phụ thuộc vào những gì bạn đang xây dựng. Bảng dưới đây là cách nhanh chóng để quyết định.

Mục tiêu của bạnKhóa hình ảnhKhóa văn bản
Tạo ảnh từ các prompt bạn tự viếtCóKhông
Tạo ảnh từ các prompt do mô hình viết hoặc mở rộngCóCó
Chỉ viết truyện, hội thoại hoặc kịch bảnKhôngCó
Xây dựng ứng dụng chat hoặc nhập vai cho người trưởng thànhKhôngCó
Sản xuất hàng loạt hàng trăm biến thể promptTùy chọnCó

Nếu bạn chỉ luôn tự viết prompt của mình và hài lòng với chúng, một khóa văn bản thêm vào rất ít giá trị. Nếu bạn thấy mình đang viết lại prompt suốt cả buổi chiều, hoặc cần khối lượng lớn, nó sẽ bù đắp chi phí nhanh chóng. Chúng tôi cũng có một hướng dẫn ngắn về cách sử dụng LLM văn bản trong quy trình video, tuân theo cùng ý tưởng về một bước văn bản trước một bước phương tiện.

Những lỗi thường gặp do nhầm lẫn khóa

Hầu hết các vấn đề trong thiết lập hai dịch vụ đều nhỏ và dễ nhận ra một khi bạn biết phải tìm gì.

  • Base URL sai. Nếu client của bạn vẫn trỏ đến máy chủ cũ, khóa mới sẽ bị từ chối. Hãy kiểm tra xem Base URL có kết thúc bằng /v1 và khớp với ví dụ ở trên không.
  • Tên mô hình sai. ID mô hình duy nhất ở đây là uncensored. Truyền tên của một mô hình ảnh sẽ trả về lỗi, vì không có mô hình như vậy trên API này.
  • Khóa trong một biến môi trường. Hãy cấp cho mỗi dịch vụ một biến riêng, ví dụ TEXT_API_KEY và IMAGE_API_KEY. Chia sẻ một tên là cách một khóa kết thúc được gửi đến máy chủ sai.
  • Mong đợi có ảnh trong phản hồi. Phản hồi là văn bản thuần trong choices[0].message.content. Nếu bạn cần một ảnh, văn bản đó phải được gửi đến dịch vụ ảnh của bạn như một yêu cầu thứ hai.
  • Bỏ qua 429. Một đợt tăng đột biến trên 8 yêu cầu đồng thời sẽ trả về 429 với mã lỗi concurrency, và trên 300 yêu cầu mỗi phút với rate_limited. Hãy tạm ngưng và thử lại. Một yêu cầu streaming giữ slot của nó cho đến khi stream kết thúc, vì vậy hãy đóng các stream bạn không còn đọc.

Khóa dùng thử có giới hạn thấp hơn: 2 yêu cầu đồng thời và 60 mỗi phút. Điều đó là đủ để kiểm tra một bước viết prompt bằng tay, nhưng một lô lớn nên chờ đợi một khóa đã được nạp tiền.

Chi phí viết prompt

Thanh toán theo token và trả trước: $0.15 cho mỗi 1M token đầu vào và $0.50 cho mỗi 1M token đầu ra, không có gói đăng ký. Các công việc prompt thường nhỏ, vì vậy các con số cũng nhỏ. Hãy lấy một yêu cầu với system message 600 token cộng với ý tưởng (đầu vào) và một prompt mở rộng 250 token (đầu ra). Chi phí đầu vào là 600 / 1.000.000 x $0.15 = $0.00009. Chi phí đầu ra là 250 / 1.000.000 x $0.50 = $0.000125. Một yêu cầu là $0.000215.

Một lô 1.000 yêu cầu như vậy do đó tốn khoảng $0.215. Tín dụng dùng thử $0.50, mà bạn có thể nhận chỉ với một cú nhấp chuột trên trang khóa sau khi đăng ký, chi trả khoảng 2.300 yêu cầu trong số đó (0,50 / 0,000215). Nó không cần thẻ và có hiệu lực trong 7 ngày. Các yêu cầu thất bại hoặc bị từ chối không bị tính phí, và tín dụng bạn thêm sau đó không bao giờ hết hạn. Chi tiết có trên trang giá cả.

Lấy khóa văn bản của bạn

Đăng ký bằng Google, hoặc bằng email và mật khẩu, sau đó mở trang khóa API. Nhận tín dụng dùng thử ở đó nếu bạn muốn thử trước. Các khoản nạp tiền trả trước dao động từ $20 đến $500 với bất kỳ số nguyên nào, với +5% bonus từ $50, +10% từ $100 và +15% từ $200. Bạn có thể thanh toán bằng crypto (USDT trên TRC20, USDC trên Base).

Giữ khóa ra khỏi mã client và các kho công khai. Các prompt bạn gửi không được dùng để huấn luyện, nhưng một khóa bị lộ sẽ tiêu tốn tín dụng của bạn. Khóa đầy đủ cho phép 8 yêu cầu đồng thời và 300 yêu cầu mỗi phút, vì vậy một lô prompt có thể chạy song song mà không cần thêm công sức.

Hỏi đáp

Tôi có thể dùng khóa này để tạo ảnh với Flux không?

Không. Khóa chỉ hoạt động với API văn bản của trang web này. Tạo ảnh cần một khóa từ nhà cung cấp lưu trữ mô hình ảnh.

Đây có phải là API Flux chính thức không?

Không. Đây là một API văn bản độc lập, được lưu trữ, tương thích OpenAI với một mô hình duy nhất, tên là uncensored. Nó không được vận hành bởi bất kỳ nhà cung cấp mô hình ảnh nào và không bán lại dịch vụ của họ.

Mô hình văn bản có thể viết prompt cho công cụ ảnh của tôi không?

Có. Hãy yêu cầu một prompt trong tin nhắn hệ thống, lấy văn bản phản hồi và dán hoặc gửi nó đến dịch vụ ảnh của bạn. Hai dịch vụ vẫn độc lập.

Tôi có cần thẻ để thử nghiệm không?

Không. Người dùng mới có thể nhận $0,50 tín dụng dùng thử chỉ với một cú nhấp chuột trên trang khóa, có hiệu lực trong 7 ngày, không cần thẻ.

Khóa của bạn chỉ cách một biểu mẫu

Tạo tài khoản, sao chép khóa, thay đổi Base URL. Đó là toàn bộ thiết lập.

Lấy khóa API