CTLink đứng giữa bạn và các hãng AI (OpenAI, Google, Anthropic, DeepSeek...). Bạn chỉ cần một tài khoản, một ví gạo, một cửa gọi — không phải mở thẻ quốc tế, không phải đăng ký từng hãng, không phải đọc tài liệu tiếng Anh của từng nhà.

CTLink bán hai thứ, và đây là điều quan trọng nhất trang này muốn bạn nhớ: bán kết quả (Xưởng nội dung — bạn mô tả, CTLink tự chọn hãng AI phù hợp và giao thành phẩm) và bán quyền gọi model qua API (bạn hoặc Coze chỉ đích danh model, CTLink chuyển lời gọi đi). Hai thứ này tính giá theo hai kiểu khác nhau — bài 3 nói kỹ.

Đơn vị tiền là gạo: 1 gạo = 1.000đ. Tài khoản mới được tặng 50 gạo để chạy thử trước khi quyết định nạp.

Nạp gạo ở màn Ví gạo, thanh toán qua PayOS. Nạp bao nhiêu dùng bấy nhiêu — không có trừ ngầm định kỳ.

Khi bạn bấm chạy, CTLink giữ tạm đúng số gạo đã báo giá — chưa phải trừ thật. Chạy xong có kết quả mới trừ thật; lỗi thì hoàn lại 100% tự động, không cần khiếu nại. Vì giá được chốt trước khi giữ, CTLink không bao giờ trừ quá con số bạn đã nhìn thấy.

Từng đồng giữ / trừ / hoàn đều nằm trong bảng Biến động gạo ở Ví & hoạt động → Ví gạo — soi được tới từng lần chạy.

Đây là chỗ người mới hay rối nhất, nên nói thẳng: CTLink có hai chế độ giá, tùy lần chạy đó dùng khóa của ai. Không phải một bảng giá bị ghi hai kiểu — mà là hai chế độ khác nhau thật.

Cách 2 áp dụng ở đâu? Trên các đường gọi máy-gọi-máy: Playground, API POST /v1/jobs, và plugin Coze — khi lần chạy đó rơi đúng hãng bạn có khóa đang bật. Các công cụ trong Xưởng nội dung luôn dùng giá trọn gói, vì ở đó CTLink tự chọn hãng AI thay bạn.

Làm sao biết lần này tính cách nào? Màn hình nói thẳng: Playground hiện dòng giá ngay dưới ô chọn model từ trước khi chạy, và mọi kết quả trả về đều ghi rõ "chạy bằng khóa riêng của bạn" hay "CTLink trả tiền hãng". Bị trừ tiền mà không biết vì sao là điều CTLink coi là lỗi nặng nhất.

CTLink có đúng hai loại khóa, tên gần giống nhau mà vai trò ngược chiều nhau:

Quy tắc chống nhầm: khóa bắt đầu bằng sk- của OpenAI (hay khóa bất kỳ do hãng phát) chỉ được dán vào thẻ 2 · Ai trả tiền model. Ô nào của Coze/Playground cũng chỉ nhận khóa do CTLink phát.

Hai loại khóa nay nằm chung một mục Kết nối & tự động hóa, mỗi loại một thẻ riêng — bảng đối chiếu này cũng in sẵn ngay đầu cả hai thẻ đó.

Đường nhanh nhất: đăng nhập CTLink xong, mở Playground (mục Kết nối & tự động hóa → thẻ 3) và bấm "Chưa có khóa? Tự tạo & kết nối ngay" — máy chủ tạo khóa kết nối hộ bạn và nối luôn, khỏi phải biết khóa nằm ở đâu. Bấm lại lần nữa là tạo khóa mới. Ba bước dưới là đường thủ công, dành cho ai muốn tự đặt tên khóa:

Bước 1. Vào Kết nối & tự động hóa → thẻ 1 · Lấy khóa kết nối → đặt tên (ví dụ "Chạy thử") → Tạo khóa mới → Sao chép ngay. Khóa đầy đủ chỉ hiện đúng một lần.

Bước 2. Mở Playground.

Bước 3. Dán khóa → bấm Kết nối. Trang liệt kê model đang mở, và hiện giá đúng của bạn cho từng model — có khóa riêng thì thấy phí nền tảng, không có thì thấy giá trọn gói.

Bước 4. Chọn model, gõ yêu cầu, bấm Tạo.

Bước 5. Xem kết quả và dòng tiền ngay dưới: giữ bao nhiêu, trừ bao nhiêu, hoàn bao nhiêu, và lần chạy này tính theo cách nào.

Yên tâm về khóa: Playground chỉ giữ khóa trong tab đang mở — đóng tab là quên, không lưu lại đâu cả.

Toàn bộ CTLink gói trong một cửa: POST /v1/jobs. Xem danh mục model bằng GET /api/v1/models (trả kèm bảng giá hai chế độ đúng theo khóa của bạn). Ví dụ gọi một model chữ:

curl -X POST https://…/v1/jobs \
  -H "X-CTLink-Key: DAN-KHOA-KET-NOI-CUA-BAN" \
  -H "Content-Type: application/json" \
  -d '{
    "plugin_id": "plugin_gpt",
    "version":   "openai:gpt-4o-mini",
    "prompt":    "Viết 3 câu giới thiệu quán phở"
  }'

Phong bì trả về luôn cùng một khuôn: status (completed / processing / failed), output (chữ nằm ở output.text, ảnh ở output.images), và billing nói thật đã giữ / trừ / hoàn bao nhiêu gạo, ai trả tiền model. Việc chạy lâu (ảnh, sau này là video) trả processing kèm retry.poll_after_seconds — hỏi lại bằng GET /v1/jobs/{id} theo đúng nhịp đó.

Sai ở lớp nào cửa báo rõ lớp đó, và mọi câu từ chối đều kèm "chưa tính gạo" khi đúng là chưa tính: sai version báo sai version, thiếu trường kể tên từng trường, model chưa mở bán nói chưa mở bán.

"Thiếu / không hợp lệ khóa truy cập CTLink" (401) — khóa kết nối gõ sai hoặc đã bị thu hồi. Tạo khóa mới ở thẻ 1 · Lấy khóa kết nối.

"Khóa API riêng của bạn... hiện mở không ra" (409) — khóa riêng bạn dán trước đây đang hỏng. Dán lại, hoặc tắt nó đi để chạy tạm bằng khóa CTLink theo giá trọn gói. Lỗi này chặn từ cửa: chưa trừ gạo nào.

"Chưa mở bán / đang bảo trì" (503) — loại việc đó chưa được đặt giá. Không trừ gạo. Playground xếp các nhóm này thành "sắp mở".

"Yêu cầu không thể xử lý" (422) — nội dung vướng vùng cấm. Không trừ gạo.

Không đủ gạo — nạp ở Ví gạo rồi chạy lại; lệnh cũ không bị treo tiền.

Nguyên tắc chung để bạn đối chiếu mọi tình huống: giá luôn hiện trước khi chạy; lỗi thì hoàn 100%; và khi CTLink nói "chưa trừ gạo nào cả" thì đó là nghĩa đen — kiểm chứng được trong bảng Biến động gạo ở Ví & hoạt động → Ví gạo.

Một dây chuyền AI là chuỗi khối nối nhau: nhận yêu cầu → soạn lời nhắc → gọi model → ráp kết quả → giao thành phẩm. Ví dụ dây chuyền video bán hàng: nhận tên + ảnh sản phẩm → GPT viết kịch bản → model ảnh dựng khung hình → ghép thành bài đăng hoàn chỉnh.

Coze là bàn lắp ráp: kéo thả các khối, không cần biết lập trình. CTLink là nguồn model cắm vào bàn đó: thay vì đăng ký từng hãng AI, mở thẻ quốc tế, quản lý chục cái khóa — bạn cắm MỘT plugin CTLink với MỘT khóa kết nối, và mọi model trong danh mục CTLink đều gọi được, trả bằng gạo.

Đường ngắn nhất cho người mới: vào khu Dây chuyền AI, lấy một mẫu có sẵn về dán — bài B. Tự thiết kế từ đầu là bài C.

Bước 1. Khu Dây chuyền AI → chọn mẫu hợp việc của bạn → bấm Sao chép mã.

Bước 2. Trong Coze: tạo workflow mới (trống) → bấm vào vùng làm việc → dán (Ctrl+V). Coze tự dựng lại toàn bộ các khối của dây chuyền.

Bước 3. Tìm các khối gọi CTLink trong dây chuyền → ô Service token → dán khóa kết nối của bạn (tạo ở Kết nối & tự động hóa → thẻ 1). Đây là khóa CTLink phát, không phải khóa sk- của hãng AI — cầm nhầm là bài 4 phần một đã dặn.

Bước 4. Bấm Test Run với một yêu cầu thật. Lượt chạy này đi qua CTLink nên tính gạo như mọi lượt: giá hiện theo hai chế độ, lỗi hoàn đủ, xem lại ở Ví & hoạt động → Lượt tạo.

Mẹo: mỗi dây chuyền dùng một khóa kết nối riêng, đặt tên theo dây chuyền — sau này thu hồi khóa nào biết ngay đứt dây nào.

Nghĩ ngược từ thành phẩm: bạn muốn giao cái gì (một video? một bộ 5 ảnh + lời chào hàng?) → cần những mảnh nào → mảnh nào cần model gì. Viết chuỗi đó ra giấy trước khi kéo khối.

Chọn model qua danh mục CTLink: GET /api/v1/models (hoặc mở Playground) cho biết model nào đang mở, thuộc plugin nào, cần input gì. Trong Coze, khối CTLink nhận plugin_id + version đúng như danh mục — dây chuyền của bạn vì thế đổi model mà không phải đập lại khối.

Ráp và thử từng đoạn: chạy thử từng khối một trước khi nối cả chuỗi — lỗi ở khối nào lộ ngay khối đó. Mỗi lượt thử qua CTLink đều báo giá trước và hoàn khi lỗi, nên thử không sợ mất oan gạo.

Khi chạy số lượng lớn: gửi kèm request_id theo từng đơn vị việc (vd video-sp-101) — chạy lại không bị tính tiền hai lần. Cách lên lịch tự động nằm ở thẻ 3 · Gọi thử & tự động hóa.