Source: 生成签名 · Category: Interface — AI Image Generation (接口-AI生图) · Updated 2026-09-22 16:32:09
English Translation
Generate Signature
Generate the merchant signature — the merchant signature rules for using the AI interface.
What to prepare before starting?
Prepare your merchant ID, merchant secret key, and the image-generation callback URL. AI uses merchant credentials, not the printer-device key.
AI tasks are asynchronous: after the task ID is returned, wait for the callback to receive the synthesized image, then submit a print task separately. A successful image generation does not automatically complete printing.
Next: Submit synthesis and receive the image →
Provides dedicated merchant-secret signature-generation rules for third-party platforms, used for identity authentication when calling AI-related interfaces and for anti-tampering verification of API data transmission, ensuring the communication security of the merchant's
partner_id+secret.
Interface Information
1. Parameter Preparation
| Parameter | Example Value | Required | Description |
|---|---|---|---|
partner_id |
2025000001 |
Yes | Merchant ID provided by the Open Platform (view in the Open Platform: Merchant Management → My Merchant → Number) |
secret |
9ce3ce7a3fccaf3d7715bd7e9bb1dc1c |
Yes | Merchant secret key provided by the Open Platform (view in the Open Platform: Merchant Management → My Merchant → Number → Merchant Details → Merchant Secret Key) |
once |
8305 |
Yes | Random value used when generating the encrypted signature |
time |
1646790335 |
Yes | Timestamp used when generating the encrypted signature |
2. Parameter Concatenation
Concatenate the parameters into a string in key=value format, following these rules:
- Arrange in the predefined parameter-name order (e.g.
partner_id→secret→once→time) - Empty-value parameters are excluded from the signature
- Case-sensitive
Example concatenated result: partner_id=2025000001&secret=9ce3ce7a3fccaf3d7715bd7e9bb1dc1c&once=8305&time=16467903353. Signature Encryption
Use the MD5 algorithm to encrypt the concatenated string and generate a 32-bit lowercase signature string.
4. Request Verification
Pass the generated signature together with the parameters above into the API interface. The enterprise-side server recalculates the signature using the same process and compares it.
Response Result
Note: The source table header repeats "参数名 参数名"; normalized below as Parameter / Example Value / Description.
| Parameter | Example Value | Description |
|---|---|---|
code |
0 |
Result status code — 0 on success, 1 on failure |
msg |
签名成功 (Signature successful) |
Result description, e.g. "Signature successful" |
data.sign |
9fdec0000746ab2426ebe1fce37 |
The returned interface signature, used as identity verification when calling AI-related interfaces |
If you encounter unsolvable issues while debugging the device, contact the cloud-printing representative for troubleshooting. Contact details: Tel: 137-5177-4454 [WeChat same number] Email: info@ColorPark.cn