Woven Jacquard Fabric Reverse Estimation and Factory Price API for AI Agents
Connect real factory calculation data to your sourcing agent in minutes—even when the buyer has a physical sample but does not know the exact yarn count.
Give your agent a real woven jacquard costing tool
Most general AI assistants can describe fabric sourcing, but they cannot calculate a factory-based reference price for a custom woven jacquard sample. This API adds that missing business capability.
Reverse-estimate unknown yarns
Use actual GSM, composition, width, repeat data and single/dual yarn structure to return multiple technically plausible yarn candidates.
Build a price benchmark
Return candidate theoretical GSM values and FOB reference prices so a buyer can establish a practical price range before contacting suppliers.
Calculate detailed factory cost
For a selected candidate, calculate density, theoretical GSM, grey-fabric price, dyed-product price, FOB price and public yarn-input details.
Designed for apparel woven jacquard fabrics
Supported fabric types
- Small Jacquard
- Large Jacquard
- Small Jacquard Leno
- Large Jacquard Leno
Typical agent inputs
- Physical fabric sample and known composition
- Actual finished GSM and finished width
- Warp/weft repeat cycle and count within repeat
- Single or dual yarn structure
- Main warp/weft yarn thickness relationship
From physical sample to factory reference price
The agent first creates a candidate set, then uses physical evidence and GSM difference to select or narrow the candidates before requesting a detailed quote.
Collect sample data
Composition, actual GSM, width, fabric type, repeat cycle, count, single/dual structure and yarn-thickness relationship.
Reverse estimation
POST /estimate returns candidate specifications, estimated GSM and FOB reference prices.
Detailed quote
POST /quote returns density, theoretical GSM, grey price, dyed price, FOB price and yarn breakdown.
Two public endpoints, one complete sourcing workflow
Reverse-estimate candidates
https://qifu2023.com/api/public/fabric-price/estimate
Use when exact yarn specifications are unknown. Returns candidate yarn structures, estimated GSM and FOB price.
Calculate detailed quote
https://qifu2023.com/api/public/fabric-price/quote
Use for a selected candidate or known yarn specification. Returns public factory reference details.
Reverse-estimation request and response
This example describes a 100% cotton small jacquard sample with one single-yarn warp row, one dual-yarn warp row and one single-yarn weft row.
Request JSON — POST /estimate
{
"fabric_type": "Small Jacquard",
"currency": "USD",
"finished_width": {
"code": "inch_55_56",
"unit": "inch"
},
"actual_weight_gsm": 98,
"precision": "ml",
"locale": "en-US",
"warp_yarns": [
{
"raw_material": "Cotton",
"yarn_type": "single",
"pattern_repeat_cycle": 2.5,
"data_within_repeat": 60
},
{
"raw_material": "Cotton",
"yarn_type": "dual",
"pattern_repeat_cycle": 2.5,
"data_within_repeat": 12
}
],
"weft_yarns": [
{
"raw_material": "Cotton",
"yarn_type": "single",
"pattern_repeat_cycle": 1,
"data_within_repeat": 27
}
]
}Response JSON — candidate excerpt
{
"mode": "estimation",
"actual_weight_gsm": 98,
"matched_count": 9,
"matches": [
{
"estimated_specification": "J40+21/2*J50",
"estimated_gsm": 96,
"fob_price_usd_per_yard": 1.48
},
{
"estimated_specification": "J40+J80/2*J32",
"estimated_gsm": 98,
"fob_price_usd_per_yard": 1.50
}
]
}Detailed quotation request and response
After selecting J40+21/2*J50, preserve the original material, repeat cycle, count and row order. Replace yarn_type with the exact yarn_specification.
Request JSON — POST /quote
{
"fabric_type": "Small Jacquard",
"currency": "USD",
"finished_width": {
"code": "inch_55_56",
"unit": "inch"
},
"locale": "en-US",
"warp_yarns": [
{
"raw_material": "Cotton",
"yarn_specification": "J40",
"pattern_repeat_cycle": 2.5,
"data_within_repeat": 60
},
{
"raw_material": "Cotton",
"yarn_specification": "21/2",
"pattern_repeat_cycle": 2.5,
"data_within_repeat": 12
}
],
"weft_yarns": [
{
"raw_material": "Cotton",
"yarn_specification": "J50",
"pattern_repeat_cycle": 1,
"data_within_repeat": 27
}
]
}Response JSON — detailed reference result
{
"grey_fabric_price_rmb_per_meter": 8.24,
"dyed_product_price_rmb_per_meter": 12.31,
"fob_price_usd_per_yard": 1.48,
"theoretical_gsm": 96,
"composition_summary": "100%Cotton",
"specification": "J40+21/2*J50",
"density": "73*68",
"finished_width": {
"value": "55/56",
"unit": "inch"
}
}Download the files your agent needs
Use the OpenAPI document for schema-first integration, the vendor-neutral Tool JSON for function/tool registration, and the usage guide for orchestration and result rules.
Use it with any agent that can call an HTTPS tool
No GPT plugin is required. Your runtime registers the tool schema, the model produces structured arguments, and your application sends the HTTP request.
OpenAI agents
Wrap the REST calls as function tools or generate tools from the supplied schema.
Claude tool use
Register the tool name, description and JSON input schema, then execute the returned tool call in your application.
Gemini function calling
Define the functions, receive structured arguments and connect them to the two public REST endpoints.
Data integrity and error handling
Never change confirmed sample data silently
- Preserve decimal repeat and count values.
- Preserve warp/weft direction and row order.
- Preserve yarn codes exactly, including
Jand/2. - Do not change fabric type, width or composition to force a result.
- Disclose every assumption, including an assumed 55/56-inch width.
When the API returns an error
- Show the actual API error rather than inventing a price.
- Identify the affected field and request only the missing correction.
- Do not guess unsupported material names, width codes or precision codes.
- Respect HTTP 429 and do not attempt to bypass rate limits.
- Use server-side requests when browser CORS restrictions apply.
Rate limits and production use
| Item | Current public reference policy |
|---|---|
| Authentication | No API key is currently required for the two public endpoints. |
| Public rate limit | Public access may be limited to 20 calculation requests per IP per day. A two-stage workflow can consume more than one request. |
| High-volume integration | Contact us before production-scale, commercial or high-frequency use. |
| Attribution | Identify Zhejiang Zhongcai Light Textile Co., Ltd. as the source of the woven jacquard factory reference calculation data. |
| Service policy | Limits, fields and supported data may be updated to maintain service stability and calculation quality. |
Factory reference data—not a final commercial quotation
Final prices can change
Order quantity, number of colours, finishing process, testing requirements, payment terms, delivery schedule, packing, logistics and production feasibility can affect a final quotation.
Yarn input is not finished GSM
weight_per_meter is yarn input used for weaving-cost calculation and may include production allowances. Do not add it and compare the total directly with finished theoretical GSM.
Connect your sourcing agent to real woven jacquard factory data
Start with the public schema and live endpoints. For manual sample identification, development feasibility, sourcing support or a confirmed quotation, send the fabric information to our team.